POST/api/astro/prashnavali/ram-shalaka/1 кредит

Рам-шалака-прашнавали

Рам-шалака-прашнавали: 225 чаупаи из «Рамачаритаманаса», расставленных в сетке девять на девять; задумав вопрос, вопрошающий указывает на клетку этой сетки. В каждой записи есть буква деванагари `letter`, по которой запись находится в традиционной сетке, сам `chaupai`, примечание `source` о том, где в эпосе встречается этот чаупаи, и `answer` на английском языке. `index` — позиция в сетке с отсчётом от 1. Если ничего не передавать, вернутся все 225 записей — обычно эндпоинт так и используют: получают данные один раз, кешируют и по выбору вопрошающего ищут запись локально. `letter` возвращает записи для одной буквы деванагари, `index` — одну запись по позиции. Астрономии здесь нет: по дате или месту ничего не рассчитывается, поэтому ответ никогда не меняется.

https://api.occultapi.com/api/astro/prashnavali/ram-shalaka/

Попробовать запрос

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

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

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

Поля запроса

Поле	Тип	Обязательно	Примечания
index	integer	необязательный	Позиция в традиционной сетке с отсчётом от 1. Если не указывать, вернутся все 225 записей. min 1 · max 225
letter	string	необязательный	Буква деванагари для поиска, например 'सु'. Если не указывать, вернутся все 225 записей.

Поле

Тип

Обязательно

Примечания

index

integer

необязательный

Позиция в традиционной сетке с отсчётом от 1. Если не указывать, вернутся все 225 записей.

min 1 · max 225

letter

string

необязательный

Буква деванагари для поиска, например 'सु'. Если не указывать, вернутся все 225 записей.

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

Этот пример ещё не проверен

Названия и типы полей ниже взяты из описания API, и они точны. Но именно это тело запроса при последнем запуске не вернуло успешного ответа: возможно, ему не хватает значения, которое мы не можем угадать. Считайте его заготовкой, а не готовой командой.

curl -X POST https://api.occultapi.com/api/astro/prashnavali/ram-shalaka/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Ответ

Проверенного примера ответа для этого эндпоинта пока нет. Структура запроса выше сгенерирована из описания API и точна. Примеры ответов мы публикуем, только когда проверим их на реальном вызове.

Ошибки

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