Giriş

API, kaynak odaklı bir REST arayüzüdür. Tüm istekler HTTPS üzerinden yapılır, gövde ve yanıtlar JSON'dur ve her istek bir API anahtarıyla imzalanır.

Dört adımda başlangıç

1. Hesap oluşturun API müşteri hesabınızı www.astrobilge.com/api-panel adresindeki API panelinden oluşturun.
2. API anahtarı üretin Plan veya endpoint paketinizi seçtikten sonra panelden anahtarınızı oluşturun ve güvenli bir yerde saklayın.
3. İlk isteği gönderin Kredi harcamayan /ping ucuyla bağlantınızı doğrulayın.
4. Üretime geçin İhtiyacınıza uygun planı veya endpoint paketini seçin ve hız limitlerinizi kontrol edin.

Örnek istek

Ücretli uçlar POST ile çağrılır ve gövdede doğum verisini bekler. Saat dilimi IANA formatında verilmelidir.

curl -X POST https://www.astrobilge.com/api/v1/chart/natal \
  -H "Authorization: Bearer ab_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-04-12",
    "time": "08:35",
    "lat": 41.0082,
    "lng": 28.9784,
    "timezone": "Europe/Istanbul"
  }'

Örnek yanıt

Başarılı yanıtlar success, data ve meta alanlarını içerir. meta bloğu isteğin id'sini (request_id), düşülen krediyi ve kalan kredi/kota bilgisini bildirir.

{
  "success": true,
  "data": {
    "chart_type": "natal",
    "chart_key": "natal",
    "title": "Doğum Haritası (Natal)",
    "png_data_uri": "data:image/png;base64,iVBORw0KGgo..."
  },
  "meta": { "request_id": "5a1f2b3c-...", "credits_charged": 1, "credits_remaining": 97, "quota_remaining": 1000 }
}

Not: chart.natal gibi çizilebilir haritalar ham astroloji verisi (gezegen/ev/açı) değil, sağ alt köşesinde "www.astrobilge.com" filigranı bulunan bir PNG döner. png_data_uri alanı doğrudan bir <img src> içinde kullanılabilir.

Kısaltılmış bir örnek — tam gerçek yanıtı Endpoint Referansı sayfasında gör →