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.
Temel adres
https://www.astrobilge.com/api/v1
İçerik tipi
application/json; charset=utf-8
Dört adımda başlangıç
- Hesap oluşturun API müşteri hesabınızı www.astrobilge.com/api-panel adresindeki API panelinden oluşturun.
- API anahtarı üretin Plan veya endpoint paketinizi seçtikten sonra panelden anahtarınızı oluşturun ve güvenli bir yerde saklayın.
- İlk isteği gönderin Kredi harcamayan /ping ucuyla bağlantınızı doğrulayın.
- Ü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,
"lon": 28.9784,
"tz": "Europe/Istanbul"
}'Örnek yanıt
Başarılı yanıtlar success, data ve meta alanlarını içerir. meta bloğu hangi SKU'nun çalıştığını, kaç kredi düşüldüğünü ve yanıtın önbellekten gelip gelmediğini bildirir.
{
"success": true,
"data": { "planets": [], "houses": [], "aspects": [] },
"meta": { "sku": "chart.natal", "credits_charged": 1, "cached": false }
}