🔮 NatalKit API

Astroloji hesaplama API'si v1.0 — 10 astroloji sistemi, natal chart, synastry, transit ve progressions

🔑 Authentication

Tüm API çağrıları X-API-Key header'ı gerektirir:

X-API-Key: nk_live_your_api_key_here

⚠️ API key'i URL query parametresi olarak göndermeyin.

📡 Endpoints

POST /v1/natal

💰 1-5 credit (karmaşıklığa göre)

Doğum verilerinden natal chart hesaplar.

POST /v1/synastry

💰 5 credit

İki kişinin doğum verilerinden ilişki uyumu hesaplar.

POST /v1/transits

💰 3 credit

Transit takvimi hesaplar (6 ay — 5 yıl).

POST /v1/progressions

💰 3 credit

Secondary progressions hesaplar.

GET /v1/systems

💰 0 credit (ücretsiz)

Kullanılabilir astroloji sistemlerinin listesi.

POST /v1/systems/{sys}

💰 2 credit

Tek astroloji sistemi hesaplama (western, vedic, egyptian, vb.)

❌ Error Codes

HTTPCodeAçıklama
401INVALID_API_KEYKey eksik, geçersiz veya revoke edilmiş
403IP_NOT_ALLOWEDIP whitelist'te yok
403ENDPOINT_NOT_ALLOWEDEndpoint izni yok
403CUSTOMER_SUSPENDEDHesap askıya alınmış
403API_EXPIREDHesap süresi dolmuş
429RATE_LIMIT_EXCEEDEDRPM/RPD limiti aşılmış
402INSUFFICIENT_CREDITSKredi yetersiz
400INVALID_REQUESTGeçersiz request
404UNKNOWN_SYSTEMBilinmeyen astroloji sistemi
500INTERNAL_ERRORSunucu hatası

📄 OpenAPI Spec

/openapi.json