Bakiye Sistemi

Nasıl Çalışır?

Her başarılı sorgu hesabınızdan belirli miktarda bakiye düşer. Düşülen bakiye miktarı sorgu türüne göre değişir.

Bakiye Maliyetleri

Endpoint	Açıklama
GET /v1/search/balance	Bakiye sorgulama (ücretsiz)
POST /v1/search/vkn	VKN ile genel bilgi
POST /v1/search/vkn/detail	VKN ile detaylı şirket kartı
POST /v1/search/title	Ünvan ile genel bilgi
POST /v1/search/title/detail	Ünvan ile detaylı şirket kartı
POST /v1/search/mersis	Mersis No ile şube kartı

Her sorgu türünün güncel bakiye tutarını API panelinizden görüntüleyebilirsiniz. Maliyetler hesabınıza tanımlı fiyatlandırmaya göre değişebilir (bayiye özel fiyatlandırma uygulanabilir).

Bakiye Düşülmez

Aşağıdaki durumlarda bakiye düşülmez:

• Geçersiz veya eksik parametre (400)
• API anahtarı hatalı (401)
• Ünvan aramasında eşleşme bulunamadı (404)
• Kurum servisi yanıt vermedi (502)

Yetersiz Bakiye

Bakiyeniz yetersizse API 402 döner:

{
  "error": "Yetersiz bakiye",
  "balance": 0.5,
  "required": 1,
  "code": "INSUFFICIENT_BALANCE"
}

Bakiye Sorgulama

curl https://api.bilvio.com/v1/search/balance \
  -H "Authorization: Bearer bil_..."

{ "balance": 150 }