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

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

logo_img fs.lip

Обновлено: 15/11/2020 в 23:01

logo_img 1001 Tasks

Обновлено: 15/11/2020 в 23:00

logo_img Stats

Обновлено: 15/11/2020 в 23:04

logo_img PlayHelper

Обновлено: 15/11/2020 в 23:03

logo_img Truth or Dare

Обновлено: 15/11/2020 в 23:04

logo_img Math

Обновлено: 15/11/2020 в 23:02

logo_img Words

Обновлено: 15/11/2020 в 23:05

logo_img 4 Pics 1 Word

Обновлено: 15/11/2020 в 23:00

logo_img Millionaire

Обновлено: 15/11/2020 в 23:02

logo_img @TurniketSKUD_bot

Обновлено: 15/11/2020 в 23:03

logo_img @NearFood_bot

Обновлено: 15/11/2020 в 23:03

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

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

Успешных запросов23673
Заблокировано запросов367
Всего пользователей≈ 753
Размер баз данных:
База данныхЗаписей
Millionaire
q = 1413
q = 2332
q = 3110
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 в случае неудачи.
amountfloat Баланс API-ключа.

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


WordData

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

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

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