İçeriğe atla
POST/api/astro/date_time/1 kredi

Saat 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/
İsteği deneyin

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ı

AlanTürZorunluNotlar
datestring (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'.

latitudenumber (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

longitudenumber (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

timestring (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_LMTbooleanisteğ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.