POST/api/astro/date_time/1 кредит

Визначення часового поясу

Перетворює годинниковий час народження й пару координат на однозначний момент. Усі інші ендпоінти потребують або мітки часу з часовим поясом, або числового зміщення від UTC, а помилка тут — найчастіша причина того, що карта непомітно зсувається на годину чи на день. Тож зазвичай із цього виклику й починають. Надішліть `date`, `time`, `latitude` і `longitude`. За координатами визначається часовий пояс IANA, дата й час без поясу інтерпретуються в цьому поясі, і ви отримуєте `input_datetime`, назву визначеного поясу `timezone`, `localized_datetime` зі зміщенням і `utc_datetime`. Локалізоване значення можна одразу передавати в `date_time` на інших ендпоінтах. Одне застереження: поле запиту називається `use_LMT`, але обробник зчитує поле з іншим написанням, тож місцевий середній час фактично ніколи не застосовується і завжди використовується пояс IANA — `use_lmt` у відповіді завжди false. Для народжень до запровадження стандартного часу в цій місцевості обчисліть зміщення місцевого середнього часу самостійно (чотири хвилини на градус довготи), а не покладайтеся на цей прапорець.

https://api.occultapi.com/api/astro/date_time/

Спробувати запит

Автентифікація

Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запиту

Поле	Тип	Обов’язкове	Примітки
date	string (date)	обов’язковий	Обмеження ФОРМАТУ, а не перелік значень. DRF DateField із типовими форматами введення = лише ISO-8601: 'YYYY-MM-DD'.
latitude	number (double)	обов’язковий	Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -180 · max 180
longitude	number (double)	обов’язковий	Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180
time	string (time)	обов’язковий	Обмеження ФОРМАТУ, а не перелік значень. DRF TimeField із типовими форматами введення = лише ISO-8601: 'HH:MM', 'HH:MM:SS' або 'HH:MM:SS.ffffff'. Зразкове значення "string" у каталозі вводить в оману.
use_LMT	boolean	необов’язковий

Приклад запиту

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}'

Відповідь

{
  "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"
}

Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.

Помилки

Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.