Firma kapsamı

Her API credential tek firmaya bağlıdır. Firma kapsamı request body içinden değil, doğrulanan credential ve gerektiğinde firma header’ı üzerinden belirlenir.

Senaryo	Header	Davranış
Okuma, firma header’ı yok	—	Credential’ın bağlı olduğu firma
Okuma, tek firma	`x-company-id`	Kimlik credential firmasıyla eşleşmelidir
Okuma, firma listesi	`x-company-ids`	Yalnız credential firmasının tek kimliği kabul edilir
Yazma işlemi	`x-company-id`	Credential firmasıyla eşleşen hedef zorunludur

Başka bir firma kimliği 403, yazma çağrısında x-company-id eksikliği 400 döndürür. Aynı entegrasyon birden fazla firmaya erişecekse her firma için ayrı API credential kullanın.

curl --request POST \
  --url https://api.tahsil.dev/banks/accounts \
  --header "x-api-key: $TAHSIL_API_KEY" \
  --header "x-api-secret: $TAHSIL_API_SECRET" \
  --header "x-company-id: 66b0f09a8f10000000000001" \
  --header 'content-type: application/json' \
  --data '{"bankCode":"aktifbank","title":"Mavi Rota tahsilat hesapları","environment":"production"}'

Hoş geldiniz

Başlangıç

Firma ve erişim

Banka bağlantıları

Banka hareketleri

Otomasyon

Operasyon

Kaynaklar