retrieve-bank-accounts
POST /api/{team}/gateway/retrieve-bank-accounts
Banka hesaplarını döndürür; hiçbir şeyi değiştirmez. Token'larını gönderdiğiniz hesaplar ya da, token göndermezseniz, çalışma alanının bütün hesapları eskiden yeniye gelir. Hesabın son okumasının ne zaman yapıldığını (synced_at) ve başarısız olduysa nedenini (last_error) buradan izlersiniz. Akış: Banka Hareketleri rehberi.
Kimlik doğrulama
X-Api-Key, X-Timestamp, X-Signature, Content-Type: application/json. Ayrıntılar: Kimlik Doğrulama ve İmza.
İstek
{ "tokens": ["5c1e9a72-3b4d-4f8e-a6c2-1d7b9e0f3a54"] }
{}
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
tokens | array | hayır | Hesapların token'ları (UUID), en fazla 50. Gönderilmezse ya da boşsa çalışma alanının bütün hesapları döner. |
Yanıt her zaman bir listedir; eşleşen hesap yoksa liste boştur. Başka bir çalışma alanının hesabı hiçbir zaman dönmez; onun token'ı hiçbir şey bulmaz.
SDK örnekleri
Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.
- PHP
- Node.js
- Python
- Java
- cURL
use Gurmehub\Odemehub\Request\RetrieveBankAccounts;
$accounts = $client->retrieveBankAccounts(new RetrieveBankAccounts([$bankAccountToken]));
// bütün hesaplar: new RetrieveBankAccounts()
$accounts->bankAccounts[0]->lastError; // son okuma başarısızsa bankanın mesajı
const accounts = await client.retrieveBankAccounts({ tokens: [bankAccountToken] });
// bütün hesaplar: client.retrieveBankAccounts()
accounts.bankAccounts[0]?.lastError; // son okuma başarısızsa bankanın mesajı
from odemehub.request import RetrieveBankAccounts
accounts = client.retrieve_bank_accounts(RetrieveBankAccounts(tokens=[bank_account_token]))
# bütün hesaplar: client.retrieve_bank_accounts()
accounts.bank_accounts[0].last_error # son okuma başarısızsa bankanın mesajı
import com.odemehub.request.RetrieveBankAccounts;
var accounts = client.retrieveBankAccounts(RetrieveBankAccounts.byTokens(bankAccountToken));
// bütün hesaplar: RetrieveBankAccounts.all()
accounts.getBankAccounts().get(0).getLastError(); // son okuma başarısızsa bankanın mesajı
URI_PATH="/api/$ODEMEHUB_TEAM/gateway/retrieve-bank-accounts"
BODY='{"tokens":["5c1e9a72-3b4d-4f8e-a6c2-1d7b9e0f3a54"]}'
TIMESTAMP=$(date +%s)
SIGNATURE=$(printf '%s\n%s\n%s\n%s' "$TIMESTAMP" "POST" "$URI_PATH" "$BODY" | openssl dgst -sha256 -hmac "$ODEMEHUB_API_SECRET" | sed 's/^.* //')
curl -X POST "https://sandbox.odemehub.com$URI_PATH" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $ODEMEHUB_API_KEY" \
-H "X-Timestamp: $TIMESTAMP" \
-H "X-Signature: $SIGNATURE" \
--data-raw "$BODY"
Yanıt
{
"result": { "successful": true, "message": null },
"bank_accounts": [
{
"token": "5c1e9a72-3b4d-4f8e-a6c2-1d7b9e0f3a54",
"provider": "enpara",
"name": "Tahsilat Hesabı",
"iban": "TR330006100519786457841326",
"synced_at": "2026-10-26T09:00:12.000000Z",
"last_error": null,
"created_at": "2026-10-26T08:12:00.000000Z"
}
]
}
| Alan | Tip | Açıklama |
|---|---|---|
bank_accounts[] | array | Banka hesabı nesneleri, eskiden yeniye. |
Banka hesabı nesnesi
Banka hesabı uçlarının hepsinde aynı nesne döner. Kimlik bilgileri (settings) hiçbir yanıtta yer almaz.
| Alan | Tip | Açıklama |
|---|---|---|
token | string | Hesabın token'ı. Hareketler retrieve-bank-transactions isteğinde bank_account_tokens ile bu token'la sorulur. |
provider | string | Bankanın kimliği: enpara. |
name | string | Hesabın adı. |
iban | string | Boşluksuz, büyük harfli IBAN. |
synced_at | string | null | Hareketlerin bankadan son başarılı okunduğu an, ISO 8601 UTC. null: hesap henüz okunmadı. |
last_error | string | null | Son okuma başarısız olduysa bankanın mesajı; başarılı bir okumadan sonra null olur. |
created_at | string | Hesabın eklendiği an, ISO 8601 UTC. |
last_error doluyken yeni hareketler gelmez. Çoğu zaman kimlik bilgilerinin süresi dolmuştur; yenilerini update-bank-account ile gönderin.
HTTP durum kodları
| Kod | Durum |
|---|---|
200 | Liste döndü; eşleşen hesap yoksa boş. |
401 | API anahtarı ya da imza geçersiz. |
403 | Çalışma alanı işlem yapamıyor ya da Banka Hareketleri modülü kapalı. |
422 | Doğrulama hatası: tokens liste değil, 50'den fazla ya da bir token UUID değil. |
429 | İstek sınırı aşıldı. |