/api/astro/activities_day_of_week/1 кредитЗанятия по дням недели
Каждым днём недели управляет планета, и ведическая традиция связывает с каждым днём свой круг благоприятных дел — определённые металлы, материалы, ремёсла и виды работ. Этот эндпоинт возвращает эти рекомендации готовым текстом на английском языке, по одному абзацу на день недели. Это статический справочник, а не расчёт: дата, место и карта не нужны, поэтому ответ для воскресенья одинаков для любого воскресенья. Им удобно подписывать дни в календаре или на экране панчанги, не сочиняя текст самостоятельно. Сначала вызовите `get_all_weeks`, чтобы получить семь допустимых названий, затем передайте одно из них в `week` вместе с `get_week_activities`. Перед поиском значение приводится к нижнему регистру, поэтому регистр не важен. Если день недели не распознан, возвращается поясняющая строка с HTTP 200, а не ошибка.
https://api.occultapi.com/api/astro/activities_day_of_week/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| keys | array | обязательный | Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами. get_week_activitiesget_all_weeks |
| week | string | необязательный | sundaymondaytuesdaywednesdaythursdayfridaysaturdayВ данных названия хранятся в нижнем регистре, и движок проверяет точное совпадение (`week not in self.info`), но сначала приводит значение к нижнему регистру, поэтому регистр не важен. Обязательно для ключа 'get_week_activities'. |
Доступные ключи (2)
Перечислите в keys ровно те расчёты, которые вам нужны. Один неизвестный ключ — и отклоняется весь запрос. Сколько бы ключей вы ни запросили, спишется 1 кредит, так что собирайте их в один вызов.
| Ключ | Доп. поля | Описание |
|---|---|---|
| get_all_weeks | — | Семь названий дней недели, которые принимает этот эндпоинт, — список строк в нижнем регистре от 'sunday' до 'saturday'. По нему можно узнать допустимые значения поля `week`. |
| get_week_activities | week | Занятия, традиционно благоприятные в день недели, указанный в `week`, — металлы, материалы, ремёсла и виды работ — одним абзацем на английском языке. Для нераспознанного дня недели возвращается строка "Invalid week: '<value>'." со статусом 200, а не ошибка. |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/activities_day_of_week/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_week_activities"],"week":"sunday"}'Ответ
{
"data": {
"get_week_activities": "This day is particularly favorable for activities involving gold, copper, horses, natural materials like dried wood and bark, woolen items, hill-related activities, healing practices, white silk work, trading activities, artistic endeavors, pure and noble activities, courageous undertakings, and fire-related work. It supports activities requiring leadership, authority, and purification."
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data под теми ключами, которые вы запросили.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.