/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. Детальніше — у довіднику помилок.