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

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

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

logo_img fs.lip

Обновлено: 25/12/2020 в 21:45

logo_img Stats

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

logo_img PlayHelper

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

logo_img Truth or Dare

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

logo_img Math

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

logo_img Words

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

logo_img 4 Pics 1 Word

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

logo_img Millionaire

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

logo_img @TurniketSKUD_bot

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

logo_img @NearFood_bot

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

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

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

Успешных запросов9797
Заблокировано запросов6
Всего пользователей 375
Размер баз данных:
База данныхЗаписей
Millionaire
q = 1418
q = 2337
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:


  • Сопоставление числа игрока и загаданного числа; проверка чисел на соответствие правилам.




    Правила игры: компьютер задумывает последовательность из разных 4 цифр (0 может стоять впереди). Цель игрока — отгадать эту последовательность. Каждый ход игрок называет последовательность из 4 разных цифр. Если угадана цифра, но не её расположение, то эта ситуация называется "корова". Если угадана цифра и её расположение, то такая ситуация называется "бык". Количество "коров" и "быков" зависит от количества совпавших цифр для каждого случая. Например, если компьютер задумал 6 1 0 9, а игрок назвал 0 1 9 3 , то компьютер скажет: "1б и 2к", где 1б - цифра 1, совпавшая по положению в числе, 2к - цифры 0 и 9, не совпавшие по положению, но имеющиеся в загаданном числе.



  • Проверка выбранной игроком цифры на существование в списке; использование искусственного интеллекта для хода компьютера.




    Правила игры: пишется ряд цифр от 0 до 9 в любой последовательности, в любых комбинациях и любой длины. Своим ходом игрок может сделать одно из двух возможных в игре действий: уменьшить на 1 одну из цифр, максимум до 0; стереть любой ноль и все цифры справа от него, сократив таким образом длину ряда. Проигрывает тот, кому остался 0.



  • Создание игрового поля; вычисление состояния игрового поля после открытия ячейки игроком.




    Игровое поле (обычно квадратное) разделено на ячейки, некоторые из которых заминированы. Целью игры является открытие всех ячеек, не содержащих мины. Игрок открывает ячейки, стараясь не открыть ячейку с миной. После открытия ячейки в ней может оказаться либо число, либо мина: число указывает на количество мин, находящихся в смежных к открытой ячейке клетках; наличие мины означает проигрыш. Игрок может пометить клетку с возможной миной флажком, чтобы не потерять её из виду или не забыть про неё. Игра считается выигранной, если все клетки, в которых нет мин, открыты.


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

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

phelper.php

"Быки и коровы"

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

Параметр Описание
typestring Название API. Установить равным "bulls_n_cows".
numstring Названное игроком число.
guessedstring Загаданное компьютером число.
apikeystring API-ключ.

Отсутствие параметра не вносит ограничений.

Баланс не изменяется.


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

Поле Описание
okboolean Результат выполнения запроса.
datavariant Вернёт при успешном выполнении запроса или число, не соответствующее правилам игрыstring, в случае неудачи.

В случае отсутствия необходимых параметров (или при их ошибочных значениях) может быть возвращено значение "null".

amountfloat Баланс API-ключа.

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


BnC-Data
Поле Описание
bullsinteger Количество "быков".

Если количество "быков" равняется 4, число считается угаданным.

cowsinteger Количество "коров".
"Цифровые войны"

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

Параметр Описание
typestring Название API. Установить равным "digital_wars".
numsstring Список цифр (текущее игровое состояние до хода игрока).
indexinteger Порядковый номер цифры (нумерация начинается с 1), выбранной игроком из списка, указанного в параметре "nums".
apikeystring API-ключ.

Отсутствие параметра не вносит ограничений.

Баланс не изменяется.


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

Поле Описание
okboolean Результат выполнения запроса.
datastring При успешном выполнении запроса вернёт одно из следующих значений:
  • изменённый список цифр после ходов игрока и компьютера;
  • значение "lose", если ход игрока был последним (игрок проиграл);
  • значение "win", если ход компьютера был последним (компьютер проиграл).

В случае отсутствия необходимых параметров (или при их ошибочных значениях) может быть возвращено значение "null".

amountfloat Баланс API-ключа.

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

"Сапёр"

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

Параметр Описание
typestring Название API. Установить равным "minesweeper".
newboolean Значение не требуется. Укажите этот параметр для генерации поля игры.

Обязателен с параметром "field_size".

field_sizestring Желаемый размер поля для генерации. Указывается в виде "cols,rows", где "cols" - количество столбцов, а "rows" - количество строк.

Используется только при наличии параметра "new".

minesinteger Желаемое количество мин.

Не должно быть меньше 1 или больше общего количества ячеек (см. параметр "field_size").

Если параметр не указан, количество мин рассчитывается по следующей формуле:

int(random(0.1 * "cols" * "rows", 0.2 * "cols" * "rows"))

(см. параметр "field_size").

Используется только при наличии параметра "new".

fieldstring Текущее состояние поля (до хода игрока). Указывается в виде перечисления состояний ячеек через запятую.
Значения состояний:
  • "n" - необследованная ячейка;
  • "m" - заминированная ячейка;
  • "f" - пустая ячейка с флагом;
  • "d" - заминированная ячейка с флагом;
  • "e" - взорванная ячейка;
  • "0-8" - значение в открытой ячейке (см. ).

Для следующего поля:
💣 💣 1️⃣
3️⃣ 2️⃣ 1️⃣
💥 1️⃣
значением параметра будет: "00mm1,nn321,ne100".

Обязателен с параметрами "cell" и "action".

cellinteger Номер ячейки, выбранной игроком, для выполнения действия, указанного в параметре "action".

Нумерация ячеек начинается с 1 с левого верхнего угла. Номер ячейки в первом столбце второй строки будет равен 9. Значение параметра не должно быть меньше 1 или больше общего количества ячеек (см. параметр "field").

Используется только при наличии параметра "field".

actionstring Действие для выбранной ячейки (см. параметр "cell").
Укажите значение "explore" для открытия ячейки.
Укажите значение "flag" для установки/снятия флага.

Будьте внимательны: в случае открытия ячейки с флагом, наличие флага в ячейке игнорируется, ячейка будет открыта.

Используется только при наличии параметра "field".

apikeystring API-ключ.

Если этот параметр не указан, максимальный размер поля будет ограничен размером 9x9, и использование параметра "mines" не допускается.


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

Поле Описание
okboolean Результат выполнения запроса.
datavariant Вернёт при успешном выполнении запроса или текст ошибкиstring в случае неудачи.
amountfloat Баланс API-ключа.

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


FieldData
Поле Описание
statusstring Состояние игры. Возможные значения:
  • "play" - игра продолжается 1;
  • "win" - ход игрока привёл к победе 2;
  • "play" - ход игрока привёл к поражению 2.

1 Вам следует отображать игровое состояние следующим образом:
  • Для значений "n" и "m" - необследованная ячейка.
  • Для значений "f" и "d" - ячейка с флагом.
  • Для значений "1-8" - ячейка с цифрой.
  • Для значения "0" - пустая ячейка (без цифры).
2 Вам следует отображать игровое состояние следующим образом:
  • Для значения "n" - необследованная ячейка.
  • Для значения "m" - ячейка с миной.
  • Для значений "f" - ячейка с флагом.
  • Для значений "d" - ячейка с деактивированной миной.
  • Для значения "e" - ячейка со взорванной миной.
  • Для значений "1-8" - ячейка с цифрой.
  • Для значения "0" - пустая ячейка (без цифры).

(см. параметр "field").

fieldstring Состояние поля после выполнения запроса (см. параметр "field").