/api/astro/combustion/1 krediYanma dönemleri
Bir gezegen, görünmeyecek kadar Güneş'e yakın olduğunda yanık sayılır — asta, yani 'batmış' — ve klasik metinler onu yanıp kül olmuş, sonuçlarını veremez durumda kabul eder. Bu endpoint, tek bir gezegenin belirli bir takvim yılına değen tüm yanma dönemlerini döndürür. Test basit bir açı testidir. Gezegen, Güneş'ten yer merkezli uzanımı gezegene özgü bir orb'un altında kaldığı sürece yanıktır: Mars için 17°, Merkür direktken 14°, retroyken 12°, Venüs direktken 10°, retroyken 8°, Jüpiter için 11° ve Satürn için 15°. Bir dönem yılbaşını aşabileceği için yıl, iki ucunda pay bırakılarak taranır; her geçiş anı ardından ikiye bölme yöntemiyle hassaslaştırılır. `planet` (mars, mercury, venus, jupiter veya saturn) ve `year` gönderin. Yanıt `{planet, year, periods, total_asta_days_in_year}` biçimindedir. Her dönemde, dönemin tamamı için `start`, `end`, `duration_days`, sorduğunuz yıla düşen kısmı için de `days_in_year` bulunur. Uzanım bulunduğunuz yere bağlı olmadığından zamanlamalar konumdan bağımsızdır; `timezone_as_float` yalnızca saatlerin nasıl gösterileceğini belirler.
https://api.occultapi.com/api/astro/combustion/
Kimlik doğrulama
Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonİstek alanları
| Alan | Tür | Zorunlu | Notlar |
|---|---|---|---|
| planet | string | zorunlu | marsmercuryvenusjupitersaturn |
| year | integer | zorunlu | Doğum yılı, sayı olarak; ör. 1990. Dört basamaklı. min 1800 · max 2400 |
| latitude | number (double) | isteğe bağlı | Yerin enlemi, ondalık derece cinsinden. Pozitif değer kuzeyi, negatif değer güneyi gösterir. Örnek: Jaipur için 26.9124, New York için 40.7128. Dakika ve saniye kabul edilmez - önce ondalık dereceye çevirin. |
| longitude | number (double) | isteğe bağlı | Yerin boylamı, ondalık derece cinsinden. Pozitif değer doğuyu, negatif değer batıyı gösterir. Örnek: Jaipur için 75.7873, New York için -74.0060. İşarete dikkat edin: eksi işaretini unutursanız New York Çin'e düşer. |
| timezone_as_float | number (double) | isteğe bağlı | Yerin UTC farkı, saat cinsinden ondalık sayı olarak. Örnek: Hindistan için 5.5 (UTC+05:30), kışın New York için -5, Nepal için 5.75. Bu değer date_time ile karşılaştırılıp DOĞRULANMAZ - ikisi birbirini tutmazsa yanlış an için başarılı bir yanıt alırsınız; bu yüzden ikisini de aynı kaynaktan alın. Bugünkü farkı değil, o tarihte geçerli olan farkı kullanın: yaz saati uygulayan bir ülkede yaz aylarında doğan biri için yaz saati farkı gerekir. min -12 · max 14 |
Örnek istek
curl -X POST https://api.occultapi.com/api/astro/combustion/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"planet":"mars","year":2026,"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Yanıt
{
"data": {
"planet": "mars",
"year": 2026,
"periods": [
{
"start": "2025-11-06T23:51:13.853078",
"end": "2026-03-26T14:07:06.209182",
"duration_days": 139.6,
"days_in_year": 84.6
}
],
"total_asta_days_in_year": 84.6
},
"message": "successful",
"is_error": false
}Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında yer alır.
Hatalar
Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.