Как работать с API

Получить API-ключ

Заказать разработку у нас

logo_img fs.lip

Обновлено: 11/08/2021 в 17:39

logo_img Stats

Обновлено: 11/08/2021 в 12:48

logo_img PlayHelper

Обновлено: 11/08/2021 в 17:14

logo_img Truth or Dare

Обновлено: 11/08/2021 в 12:49

logo_img Math

Обновлено: 28/10/2021 в 00:08

logo_img Words

Обновлено: 11/08/2021 в 12:49

logo_img 4 Pics 1 Word

Обновлено: 11/08/2021 в 17:11

logo_img Millionaire

Обновлено: 11/08/2021 в 17:08

logo_img @TurniketSKUD_bot

Обновлено: 12/09/2021 в 05:17

logo_img @NearFood_bot

Обновлено: 25/12/2020 в 09:41

Статистика запросов:

(с начала месяца)

Успешных запросов1011
Заблокировано запросов3
Всего пользователей≈ 134
Размер баз данных:
База данныхЗаписей
Millionaire
q = 1415
q = 2338
q = 3112
q = 450
На проверке0
Words
Города5432
Страны178
Английские слова7995
Русские слова19403
4 Pics 1 Word
Доступно24
На проверке0
Truth or Dare
Вопросы283
Действия78
На проверке0

Описание

База русских слов (в основном, существительных), английских, а также названий стран и городов. Особенность базы заключается в том, что она содержит только те слова (или названия), которые пишутся без разделителей. На основе данной базы созданы игры "Виселица" и "Анаграммы" в боте @PaperGames_bot.

Использование сервиса

Взаимодействие с API

words.php

Параметры запроса

Если указано несколько параметров выборки слов (это параметры: "rus", "eng", "countries", "cities"), будет выбран случайный.

Будьте внимательны: должен быть указан хотя бы один параметр выборки слов.

Параметр Описание
rusboolean Значение не требуется. Укажите этот параметр, чтобы получить слово из базы русских слов.

• Самое короткое слово: 2 символа.
• Самое длинное слово: 24 символа.

engboolean Значение не требуется. Укажите этот параметр, чтобы получить слово из базы английских слов.

• Самое короткое слово: 1 символ.
• Самое длинное слово: 16 символов.

countriesboolean Значение не требуется. Укажите этот параметр, чтобы получить слово из базы названий стран.

• Самое короткое название: 3 символа.
• Самое длинное название: 14 символов.

citiesboolean Значение не требуется. Укажите этот параметр, чтобы получить слово из базы названий городов.

• Самое короткое название: 2 символа.
• Самое длинное название: 18 символов.

lengthstring

См. примечания в параметрах выборки.

Желаемая длина слова. Указывается в виде "min,max", где "min" - минимальная длина, а "max" - максмальная.

Значение "min" не должно быть больше значения "max".

Если хотя бы одно из значений указано неверно, параметр игнорируется.
apikeystring API-ключ.

Если этот параметр не указан, размер выборки будет ограничен: по 3 слова на каждую букву, 10 стран и 10 городов, а также параметр "length" игнорируется.


Структура ответа

Поле Описание
okboolean Результат выполнения запроса.
datavariant Вернётobject WordData при успешном выполнении запроса или текст ошибкиstring в случае неудачи.
infostring Важная информация о запросе, на которую следует обратить внимание (например, информация об использовании устаревшего параметра).

Поле может отсутствовать.
amountfloat Баланс API-ключа.

Если параметр "apikey" не был указан, вернёт "-1".


WordData

В случае непредвиденной ошибки поля могут иметь значения "null".

Поле Описание
wordstring Слово (или название).
explanationstring Пояснение к слову (или названию), указанному в поле "word".

Может быть пустым.