Postman ile Test

Adım Adım

1. Yeni İstek Oluştur

• Sol üstteki + butonuna tıklayın
• Method olarak POST seçin (GET değil!)
• URL: https://api.bilvio.com/v1/search/vkn

2. API Anahtarını Ekle

• Authorization sekmesine tıklayın
• Type: Bearer Token seçin
• Token alanına API anahtarınızı yazın:

  bil_your_api_key_here

3. Sorgu Bilgisini Ekle

• Body sekmesine tıklayın
• raw seçin, sağdaki açılır menüden JSON seçin
• Aşağıdaki metni yazın:

VKN ile sorgu:

{
  "vkn": "9000500394"
}

Ünvan ile sorgu:

{
  "title": "UYUMSOFT"
}

Şube kartı:

{
  "mersis_no": "0900050039400002"
}

4. Send Butonuna Basın

---

Tüm Endpoint'ler

Sorgu	Method	URL
Bakiye	GET	https://api.bilvio.com/v1/search/balance
VKN genel	POST	https://api.bilvio.com/v1/search/vkn
VKN detaylı	POST	https://api.bilvio.com/v1/search/vkn/detail
Ünvan genel	POST	https://api.bilvio.com/v1/search/title
Ünvan detaylı	POST	https://api.bilvio.com/v1/search/title/detail
Şube kartı	POST	https://api.bilvio.com/v1/search/mersis

Bakiye dışındaki tüm sorgular POST metodudur.

---

Yaygın Hatalar

Hata	Sebebi	Çözüm
Route GET:/v1/search/vkn not found	Method GET seçilmiş	POST yapın
Gecersiz API anahtari	Authorization eksik veya yanlış	Bearer Token doğru girildi mi?
VKN zorunlu	Body boş	Body → raw → JSON ekleyin
Yetersiz bakiye	Bakiyeniz bitti	Yöneticinizden bakiye yüklemesi isteyin