API для разработчиков
Небольшой API только для чтения, который даёт доступ к публичным данным 1in8B, опубликованным под псевдонимами: заметкам игроков о завершившихся жизнях и ссылкам, которыми они делятся. Без ключей, учётных записей и оплаты.
Для кого этот API
Для исследователей, студентов и энтузиастов, которым нужен доступ к публичным данным 1in8B, опубликованным под псевдонимами, без открытия браузера. API предоставляет те же данные, что и публичный сайт: он не добавляет ничего приватного и ничего не убирает из игры.
Лента опубликованных заметок
GET https://in8b.com/api/posts?lang=en возвращает последние опубликованные заметки в формате JSON: {"ok":true,"posts":[…],"more":false}. Каждая запись содержит id, lang, name (имя вымышленного персонажа), iso (код страны), sex, age, text, rem (сколько игроков её запомнили) и at (время Unix в миллисекундах). Добавьте &before=<last id>, чтобы постранично просматривать более ранние записи. lang фильтрует заметки по коду языка сайта; если не указать этот параметр или допустить опечатку в коде, будут возвращены заметки на всех языках вперемешку, поэтому для заметок на английском укажите lang=en.
Ссылки на опубликованные жизни
Результат, которым можно поделиться, можно опубликовать в виде короткой ссылки, https://in8b.com/s/<key>. При переходе по ссылке видны только отображаемое имя, страна и возраст. Ссылки хранятся 120 дней; дневники, принятые решения и причины смерти в них никогда не включаются.
Обнаружение страниц сайта
https://in8b.com/robots.txt содержит правила обхода, а https://in8b.com/sitemap.xml перечисляет все публичные страницы, включая эту.
Основные правила
Указывайте 1in8B (in8b.com) в качестве источника, когда представляете данные. Ограничивайтесь примерно одним запросом в секунду и по возможности используйте кеширование. Содержание вымышлено и основано на общедоступной статистике по странам: никогда не представляйте его как прогноз о каком-либо реальном человеке и не используйте для создания клона игры или обучения моделей, которые её имитируют.
Что не является публичным
Публикация заметок, сохранение памяти об описанных в них жизнях, отправка жалоб и удаление заметок остаются внутри игры, защищены собственными механизмами и не входят в этот API. Резервные копии Cloud Life Keep, дневники и незавершённые жизни никогда не раскрываются. Запросы из браузера между разными источниками не разрешены, поэтому читайте ленту с сервера. Учётных записей, панели квот и страницы состояния нет; если запрос завершился ошибкой, подождите и повторите попытку позже.
Изменения и связь
Конечные точки могут меняться по мере развития игры; существенные изменения будут отмечены на этой странице. Вопросы и сообщения о проблемах: [email protected].