API Genel Bakış

Base URL

https://api.bilvio.com

Endpoints

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

Sorgu başına düşülen güncel bakiye tutarlarını API panelinizden görüntüleyebilirsiniz.

İstek Formatı

Tüm POST istekleri JSON body ve Authorization başlığı gerektirir:

POST /v1/search/vkn HTTP/1.1
Host: api.bilvio.com
Authorization: Bearer bil_...
Content-Type: application/json

{"vkn": "9000500394"}

Yanıt Formatı

Başarılı yanıt

{
  "success": true,
  "dusulen_bakiye": 1,
  "response_time_ms": 245,
  "data": { ... }
}

Ünvan aramasında ek alanlar

{
  "success": true,
  "dusulen_bakiye": 2,
  "matched": {
    "ad": "UYUMSOFT KURUMSAL İŞSİSTEMLERİ VE TEKNO.A.Ş.",
    "vkn": "9000500394",
    "score": 0.9412
  },
  "alternatives": [
    { "ad": "UYUMSOFT BİLİŞİM LTD.ŞTİ.", "vkn": "1234567890", "score": 0.41 }
  ],
  "data": { ... }
}

matched.score → 0.0–1.0 arası benzerlik skoru. 1.0 = tam eşleşme.

Hata yanıtı

{
  "error": "Açıklayıcı mesaj",
  "code": "HATA_KODU"
}