Kimlik Doğrulama

API Anahtarı Nedir?

API anahtarı, sisteme bağlanmak için kullandığınız şifredir. Her istekte bu anahtarı gönderirsiniz; sistem böylece kim olduğunuzu ve ne kadar bakiyeniz kaldığını bilir.

Anahtarınız şöyle görünür:

bil_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Anahtarınızı hesap yöneticinizden alırsınız. Oluşturduktan sonra yalnızca bir kez gösterilir — kaybetmemek için not alın.

---

Nasıl Kullanılır?

Her istekte anahtarı Authorization alanında gönderirsiniz. Kullandığınız dile göre örnek:

JavaScript

// API anahtarınızı buraya yazın
const API_KEY = 'bil_your_api_key_here'

const response = await fetch('https://api.bilvio.com/v1/search/vkn', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,   // ← anahtar buraya
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ vkn: '9000500394' }),
})

Python

import requests

API_KEY = 'bil_your_api_key_here'

response = requests.post(
    'https://api.bilvio.com/v1/search/vkn',
    json={'vkn': '9000500394'},
    headers={
        'Authorization': f'Bearer {API_KEY}',   # ← anahtar buraya
        'Content-Type': 'application/json',
    }
)

PHP

$apiKey = 'bil_your_api_key_here';

$ch = curl_init('https://api.bilvio.com/v1/search/vkn');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer $apiKey",    // ← anahtar buraya
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['vkn' => '9000500394']),
]);
$result = json_decode(curl_exec($ch), true);

cURL (terminal)

curl -X POST https://api.bilvio.com/v1/search/vkn \
  -H "Authorization: Bearer bil_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"vkn": "9000500394"}'

---

Anahtarınızı Koruyun

• Anahtarı başkasıyla paylaşmayın — kim kullanırsa bakiyenizi harcar
• Kaynak koduna doğrudan yazmak yerine ortam değişkeni (.env) kullanın
• Anahtarın ele geçirildiğini düşünüyorsanız yöneticinizden yeni anahtar isteyin

---

Hata Alıyorsanız

Durum	Ne anlama geliyor
Gecersiz API anahtari	Anahtar yanlış yazılmış ya da silinmiş
API anahtari devre disi	Anahtar yönetici tarafından kapatılmış
Hesap askiya alinmis	Hesabınız durdurulmuş, yöneticinize ulaşın
Yetersiz bakiye	Bakiyeniz bitti, yöneticinizden yükleme isteyin