API Dokümantasyonu

Kimlik Doğrulama

API anahtarı oluşturma, Bearer token kullanımı, anahtar güvenliği ve hız limiti başlıkları.

Her istek bir API anahtarı gerektirir. Anahtar, Authorization başlığında Bearer şeması ile gönderilir; sorgu parametresi olarak anahtar kabul edilmez.

İstek başlığı

Aşağıdaki başlığı her isteğe ekleyin. Başlık eksikse veya anahtar geçersizse 401 yanıtı döner.

Authorization: Bearer ab_live_xxxxxxxxxxxxxxxxxxxxxxxx

Anahtarı nereden alırım?

API anahtarları yalnızca www.astrobilge.com/api-panel adresindeki API müşteri panelinden üretilir; ana site hesabınız API erişimi vermez. Panelde API müşteri hesabınızı açın, bir plan veya endpoint paketi satın alın, ardından anahtarınızı oluşturun.

API paneline git

Anahtar yaşam döngüsü

  1. Oluşturma Anahtarın tam değeri yalnızca oluşturma anında bir kez gösterilir; sonrasında yalnızca son karakterleri görünür.
  2. Döndürme Planınızın izin verdiği anahtar sayısı kadar paralel anahtar tutabilir, eskisini kapatmadan yenisine geçebilirsiniz.
  3. İptal Sızdığından şüphelendiğiniz anahtarı panelden anında iptal edin; iptal edilen anahtarla yapılan istekler 401 alır.

Anahtar formatı

Canlı anahtarlar ab_live_ ön ekiyle başlar. Ön ek, anahtarın kod tabanında yanlışlıkla paylaşılması durumunda tespit edilmesini kolaylaştırır.

Anahtarı istemciye koymayın

API anahtarı yalnızca sunucu tarafında saklanmalıdır. Tarayıcı, mobil uygulama paketi veya herkese açık bir depoya konulan anahtarlar kredi tüketimine ve kötüye kullanıma açıktır.

Hız limiti başlıkları

Her yanıt, kalan istek hakkınızı bildiren başlıklar taşır. Limit aşıldığında 429 döner ve Retry-After başlığı kaç saniye beklemeniz gerektiğini söyler.

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
Retry-After: 24