/api/astro/date_time/1 krediSaat dilimi bulucu
Duvar saatine göre verilmiş bir doğum saatini ve bir koordinat çiftini, yoruma yer bırakmayan kesin bir ana dönüştürür. Buradaki diğer tüm endpoint'ler ya saat dilimi bilgisi içeren bir zaman damgası ya da sayısal bir UTC farkı bekler. Bunun yanlış verilmesi, haritanın fark edilmeden bir saat ya da bir gün kaymasının en yaygın nedenidir; bu yüzden genellikle ilk yaptığınız çağrı bu olur. `date`, `time`, `latitude` ve `longitude` gönderin. Koordinatlardan bir IANA saat dilimi bulunur, saat dilimi içermeyen tarih ve saat bu dilime göre yorumlanır. Yanıtta `input_datetime`, bulunan `timezone` adı, farkı eklenmiş `localized_datetime` ve `utc_datetime` döner. Yerelleştirilmiş değeri diğer endpoint'lerde doğrudan `date_time` alanına verin. Bir çekince: istek alanı `use_LMT` olarak yazılır, ama görünüm farklı yazılmış bir adı okur; bu yüzden yerel ortalama zaman hiçbir zaman uygulanmaz ve her zaman IANA dilimi kullanılır — yanıttaki `use_lmt` her zaman false'tur. Standart saate geçilmeden önceki doğumlar için bu bayrağa güvenmeyin; yerel ortalama zaman farkını kendiniz hesaplayın (boylamın her derecesi için dört dakika).
https://api.occultapi.com/api/astro/date_time/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 |
|---|---|---|---|
| date | string (date) | zorunlu | BİÇİM kısıtı, enum değil. Varsayılan giriş biçimleriyle DRF DateField, yani yalnızca ISO-8601: 'YYYY-MM-DD'. |
| latitude | number (double) | zorunlu | 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. min -180 · max 180 |
| longitude | number (double) | zorunlu | 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. min -180 · max 180 |
| time | string (time) | zorunlu | BİÇİM kısıtı, enum değil. Varsayılan giriş biçimleriyle DRF TimeField, yani yalnızca ISO-8601: 'HH:MM', 'HH:MM:SS' veya 'HH:MM:SS.ffffff'. Katalogdaki "string" örnek değeri yanıltıcıdır. |
| use_LMT | boolean | isteğe bağlı | |
Örnek istek
curl -X POST https://api.occultapi.com/api/astro/date_time/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"1980-09-05","time":"04:42:05.037Z","longitude":80,"latitude":23,"use_LMT":true}'Yanıt
{
"input_datetime": "1980-09-05 04:42:05",
"latitude": 23,
"longitude": 80,
"timezone": "Asia/Kolkata",
"use_lmt": false,
"localized_datetime": "1980-09-05T04:42:05.037000+05:30",
"utc_datetime": "1980-09-04T23:12:05.037000+00:00"
}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.