Ana içeriğe atla
GET

Ne yapar?

Firma kapsamındaki banka hareketlerini filtreler. Yanıtta result ve total bulunur; paginate nesnesi dönmez. Tarih filtresi başlangıç gününün 00:00:00 anını dahil eder, bitiş gününün 23:59:59 anını hariç tutar. Yan etkiler: Kalıcı mali kayıt oluşturmaz. Sonraki adım: Bir hareketin ham ayrıntısı için GET /apps/bank/transaction/{id}?detail=true çağırın.

Ön koşullar ve izin

Etkin API anahtarı ve muhasip:bank:read izni gerekir. İlişkili kayıtlar aynı firmaya ait olmalıdır. Erişim ayarları için kimlik ve izinler rehberini inceleyin. İstek ve cevap şemalarını indirin.

İstek örnekleri

Örnekler temsilîdir. Kimlikleri, belge tarihlerini ve iş verisini kendi yetkili kayıtlarınızla değiştirin. Node.js örnekleri Node.js 20 veya üzeri içindir; PHP örnekleri cURL uzantısını kullanır. Hiçbiri otomatik tekrar yapmaz.

Cevabı değerlendirin

Önce HTTP durumunu, ardından bu kaynağın status ve sonuç alanlarını değerlendirin. Bütün uçlar aynı sonuç zarfını veya oluşturma için 201 kodunu kullanmaz. Temsilî başarılı cevap; gerçek hizmet çağrısından alınmamıştır:

Hata durumunda

Ağ kesintisi, zaman aşımı veya JSON olmayan cevap mali etkinin oluşmadığını kanıtlamaz. Ham istek/cevapları genel loglara yazmayın. Hata yönetimi

Sonraki adım

Dönen kimlik ve durumları saklayın; iş akışınızın ilgili detay veya yazma adımında kullanın. Kaynak akışı · İşlem takibi · Kapsam ve sınırlamalar

Yetkilendirmeler

Authorization
string
header
gerekli

Kullanıcı adı apiUserId, parola secretKey. Aktif ve süresi geçmemiş API kullanıcısı ve uygun firma gerekir.

Sorgu Parametreleri

incoming
enum<string>

Gelen/giden hareket filtresi; verilmezse her iki yön.

Mevcut seçenekler:
true,
false
status
enum<string>

Mevcut boolean metin filtresi sayısal durum alanına uygulanır; true=1, false=0. Bu parametreyle 2 seçilemez.

Mevcut seçenekler:
true,
false
bank
string[]

Ana hesap kimliği listesi; bank[0], bank[1] biçiminde iletin.

24 haneli kayıt kimliği; firma API kimliğinden belirlenir.

Pattern: ^[a-fA-F0-9]{24}$
currency
string[]

Para birimi kodu listesi; currency[0] biçiminde iletin.

date
string<date>[]

date[0] başlangıç, date[1] bitiş. startDate/endDate çiftinden önceliklidir.

Required array length: 2 elements

Belge tarihi; tarih-saat sunucu tarafından düzenlenir.

startDate
string<date>

Başlangıç tarihi; endDate ile birlikte kullanılır. Belge tarihi; tarih-saat sunucu tarafından düzenlenir.

endDate
string<date>

Bitiş tarihi; startDate ile birlikte kullanılır. Belge tarihi; tarih-saat sunucu tarafından düzenlenir.

dayMode
string

Açık tarih aralığı yoksa mevcut dönem seçimi kullanılır; özel dönem adı varsaymayın.

order
enum<string>
varsayılan:false

true: eskiden yeniye; aksi halde yeniden eskiye.

Mevcut seçenekler:
true,
false
page
integer
varsayılan:1

Sayfa; toplamı aşarsa son sayfa kullanılır.

Gerekli aralık: x >= 1
pageSize
integer
varsayılan:25

Sayfa başına kayıt.

Gerekli aralık: 1 <= x <= 250

Yanıt

İşlem tamamlandı. Örnek değerler temsilîdir.

status
boolean
gerekli
result
object[]
gerekli
total
integer
gerekli