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