Başlangıç ve kimlik doğrulama

Anahtar oluşturma

1. Müşteri panelinde Güvenlik → API Anahtarları bölümünü açın.
2. Entegrasyonu tanımlayan bir ad, yalnız gerekli kapsamlar ve mümkünse sınırlı bir geçerlilik süresi seçin.
3. Oluşturulan sb_live_… anahtarını hemen güvenli bir konuma kaydedin. Tam anahtar ikinci kez gösterilmez.

Bir hesapta en fazla 10 etkin anahtar bulunabilir. Her entegrasyon için ayrı anahtar kullanmak, gerektiğinde yalnız etkilenen anahtarı kapatmanızı sağlar.

İlk istek

Önerilen kimlik doğrulama biçimi Bearer başlığıdır:

curl --fail-with-body \
  -H "Authorization: Bearer $SOURCE_API_KEY" \
  -H "Accept: application/json" \
  https://api.sourcebilisim.com/v1/key

X-API-Key başlığı da desteklenir; standart Authorization: Bearer biçimini tercih edin. Anahtarı URL'ye veya sorgu parametresine koymayın.

Hesap profili örneği:

curl --fail-with-body \
  -H "Authorization: Bearer $SOURCE_API_KEY" \
  https://api.sourcebilisim.com/v1/me

Bu çağrı için anahtarda account:read kapsamı bulunmalıdır.

Anahtar yaşam döngüsü

• Üretim ve geliştirme için farklı anahtarlar oluşturun.
• Süresiz anahtar yerine 30 veya 90 günlük süre tercih edin.
• Kullanılmayan anahtarları hemen devre dışı bırakın.
• Bir sızıntı şüphesinde anahtarı döndürün; eski anahtarı beklemeden iptal edin.
• Kullanımı API İstek Geçmişi bölümünden düzenli kontrol edin.

401 INVALID_API_KEY, anahtarın geçersiz, süresi dolmuş, iptal edilmiş veya hesabın etkin olmadığını belirtir. Yanıtta anahtarın neden reddedildiği ayrıştırılmaz; bu davranış bilgi sızıntısını önler.