Разработчикам

Что он умеет

Пять конечных точек, у каждой одно дело: выбрать победителей из списка, разделить список на равные команды, опубликовать список как общее колесо, провести розыгрыш с публикуемой записью и прочитать эту запись обратно, чтобы её проверить. В каждом успешном ответе есть ссылка на страницу, которую откроет человек, — помощник, который этим воспользовался, может показать, как получил результат.

Бесплатно, как и всё остальное

Платного тарифа нет, счетов нет, карта не нужна. Ключ бесплатный и выдаётся вместе с аккаунтом, а аккаунт — это адрес почты и ссылка, без пароля. Здесь ничто не идёт в счёт; ограничения ниже нужны только для того, чтобы один вызывающий не израсходовал дневной запас за всех.

Как получить ключ

Войдите на странице аккаунта и нажмите кнопку. Ключ показывается один раз, потому что хранится только его отпечаток, — скопируйте его сразу. Отправляйте его в заголовке Authorization: Bearer. Ключей можно держать несколько, называть их, чтобы помнить, у какой программы какой, и отзывать любой в любой момент.

Аккаунт

Ограничения

Без ключа — 60 вызовов в сутки с одного адреса. С ключом — 5000 вызовов в сутки на аккаунт, сколько бы ключей у него ни было. Оба окна обнуляются в полночь по UTC. Сверх нормы ответ будет 429 и заголовок с числом секунд ожидания.

Это не инструмент для азартных игр

Он никогда не касается денег. Здесь нет билетов, вступительных взносов, призов и шансов на выигрыш — ни на одном языке — и не появится: инструмент, который занимался бы этим, был бы другим продуктом с другой лицензией. Пользуйтесь им, чтобы честно выбрать из списка, который у вас уже есть.

Условия

На API распространяются те же условия, что и на страницы, плюс три вещи: его нельзя использовать для азартных игр, для травли и для пропаганды насилия или самоповреждения; ограничения могут измениться без предупреждения; и никакого обещания об уровне сервиса нет вовсе — не стройте на нём ничего критичного.

Условия

Версии и изменения

Версия указана в пути. Изменение, которое сломало бы вызывающего, выходит новой версией, а не правкой этой, и снятая версия продолжает отвечать не меньше шести месяцев после того, как о её снятии объявлено здесь. Новые поля могут появиться в ответе в любой момент — читайте их снисходительно.

Сервер MCP

Помощник, который говорит на Model Context Protocol, умеет всё это, не составляя HTTP-запросы сам. Сервер отвечает по одному адресу, одно сообщение на запрос, без сессии, которую надо открывать и закрывать, и предлагает четыре инструмента: выбрать победителя, разделить на команды, опубликовать колесо и проверить розыгрыш, который провёл кто-то другой. Он тратит тот же ключ и те же вызовы в сутки, что и конечные точки, так что от выбранной двери не зависит ничего из того, что вам разрешено. Имена инструментов ниже — часть протокола, поэтому они по-английски.

POST /mcp

pick_winner
make_teams
create_wheel
verify_draw

Справочник

Каждая конечная точка, её поля и ответы, которые она может дать. Машиночитаемое описание того же самого лежит в одном файле:

/openapi.json

Справочник по конечным точкам написан по-английски.