Помощник для определения временной зоны при составлении гороскопов¶

Используйте этот помощник, чтобы получить список допустимых идентификаторов IANA временных зон перед вызовом маршрутов отчетов о днях (today, yesterday, tomorrow).

Он предотвращает ошибки, связанные с изменением даты в разных регионах, и гарантирует, что пользователи в разных географических точках правильно определяют местную дату.

Конечная точка (Endpoint)¶

Метод	Путь
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/timezones`

Аутентификация¶

Предоставьте заголовок с вашим API-ключом:

X-API-Key: YOUR_API_KEY

Параметры запроса¶

Эта конечная точка не требует параметров запроса или тела.

Пример запроса¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/timezones" \
  --header "X-API-Key: YOUR_API_KEY"

Пример ответа¶

{
  "count": 596,
  "timezones": [
    "Africa/Abidjan",
    "Africa/Accra",
    "Africa/Addis_Ababa"
  ]
}

Поля ответа¶

Поле	Тип	Описание
`count`	integer	Общее количество допустимых идентификаторов временных зон, возвращенных.
`timezones`	array[string]	Поддерживаемые имена IANA временных зон.

Рабочий процесс интеграции¶

Вызывайте /api/v1/horoscope/timezones один раз и сохраняйте список в вашем бэкенде/клиенте.
Проверьте выбранную пользователем временную зону на соответствие этому списку.
Отправляйте проверенную временную зону в запросах ежедневного отчета.

Пример ежедневного запроса с указанием временной зоны:

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/reports/today?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "sign": "TAURUS",
  "timezone": "America/New_York",
  "sections": ["general"]
}'

Примечания¶

Используйте допустимый формат IANA (например: America/New_York, Africa/Douala, Asia/Tokyo).
Избегайте сокращений, таких как EST, PST или GMT+1.
Значение count может незначительно отличаться в зависимости от окружения и версии tzdata.