КогдаИгра: Автоматизированные запросы

Нет нужной игры? Добавьте самостоятельно или напишите в

Сайт kogda-igra поддерживает прием простых автоматических запросов. Данные не претендуют на полноту, но возможно развитие по запросам пользователей. Если вам нужны эти данные — пишите (rpg@kogda-igra.ru), разовьем до полноценного API.

Данное API используется для создания кросс-ссылок с сайтом allrpg.info, но может быть использовано всеми желающими.

На все запросы дается ответ — объект в формате JSON. Если данные не найдены, возвращается пустой объект.

Получение данных об игре по ее id.
URI: /api/game/(id)
Выдает объект с данными об игре по ее номеру (id). Id игры можно заметить в URI профиля. Т.е. http://kogda-igra.ru/game/152 — id=152. Выдаются все общедоступные данные. Специальные случаи:

Если игра закрыта от просмотра неавторизованными пользователями, выдается ответ вида {"id":"(id)", "access-denied":"1"}.
Если id не верный, выдается пустой объект.
Если запись об игре слита с другой записью, то выдается перенаправление: {"id":"(id)", "redirect_id":"(новый id)"}. В этом случае рекомендуется обновить ссылку так, чтобы она указывала на новую запись.

Получение данных об обновлениях с определенного timestamp.
URI: /api/changed/(timestamp)
Выдает все обновленные игры с timestamp (UNIX timestamp).

Поиск игры по идентификатору в базе Allrpg.info.
URI: /api/allrpg-info/(allrpg-info-id)
По номеру профиля в базе сайта allrpg.info (allrpg-info-id) ищет соответствующую игру в базе kogda-igra. Если игра, ссылающаяся на указанный id, есть то выдается ответ вида {"id":"440","allrpg_info_id":"1356","profile_uri":"\/game\/440"}, где id — идентификатор в базе kogda-igra, allrpg_info_id — идентификатор в базе allrpg.info, profile_uri — ссылка на профиль в формате «для людей».