API
Содержание:
Игра в демо-режиме
Этот метод можно использовать для интеграции с системой, создания ботов и игры в ассоциации в демо-режиме без регистрации извне. Через этот метод работает демо-режим в самой игре.
Метод: POST
URL: https://associ.ru/api/v1/play
Данные:
{
lang_code: <string, optional>,
word: <string, optional>,
prev_word_id: <int, optional>
}
При запуске без параметров система вернет случайное общее слово на русском языке в параметре ответа new.
- lang_code — код языка, на котором идет игра.
- По умолчанию игра идет на русском языке (код = 'ru').
- Если в системе нет языка с указанным кодом, будет возвращен ответ (400) Bad request.
- Пока в системе только один язык, хотя технически она уже сейчас поддерживает несколько языков, просто для них еще нет UI.
- Список языков с кодами можно будет получить по запросу https://associ.ru/api/v1/languages (пока не можно).
- word — слово, на которое система должна ответить.
- Если в системе есть общие ассоциации, связанные с этим словом, будет возвращена случайная из них в параметре ответа answer.
- Иначе будет возвращено случайное общее слово в параметре ответа new, как и в случае отсутствия параметра word.
- prev_word_id — id слова, на которое отвечает игрок.
- Передача этого параметра сообщает системе, что это слово не должно быть возвращено в качестве ответа (для предотвращения зацикливания).
- Также при наличии в системе ассоциации между word и prev word в ответе будет возвращена информация о ней.
Примеры
- Запрос нового слова: https://reqbin.com/iincry2s
- Запрос ответа на слово «школа» (с предыдущим словом «доска»): https://reqbin.com/8jxtq7bn
kapxapot
