Desenvolvedores

O que ela faz

Cinco endpoints, um ato cada: escolher vencedores de uma lista, dividir uma lista em times equilibrados, publicar uma lista como roleta compartilhada, fazer um sorteio com registro publicado e ler esse registro de volta para conferi-lo. Toda resposta bem-sucedida traz um link para uma página que uma pessoa abre, então o assistente que usou um deles consegue mostrar como chegou ao resultado.

Gratuita, como todo o resto

Não há plano pago, nem cobrança, nem cartão. A chave é gratuita e vem com uma conta, e uma conta é um endereço de e-mail e um link — sem senha. Aqui nada entra numa fatura; os limites abaixo existem só para que um chamador não gaste a capacidade do dia de todo mundo.

Como pegar uma chave

Entre na página da sua conta e aperte o botão. A chave aparece uma única vez, porque guardamos apenas a impressão digital dela — copie na hora. Envie-a num cabeçalho Authorization: Bearer. Você pode manter várias chaves, dar nome a elas para saber qual programa tem qual, e revogar qualquer uma quando quiser.

Conta

Limites

Sem chave: 60 chamadas por dia de um endereço. Com chave: 5000 chamadas por dia para a conta, tenha ela quantas chaves tiver. As duas janelas zeram à meia-noite UTC. Passando da cota, a resposta é 429, com um cabeçalho dizendo quantos segundos esperar.

Não é ferramenta de jogos de azar

Ela nunca encosta em dinheiro. Não há bilhetes, taxas de inscrição, prêmios nem probabilidades de ganhar em lugar nenhum, em idioma nenhum, e não vai haver: uma ferramenta que cuidasse disso seria outro produto, com outra licença. Use-a para escolher com justiça dentro de uma lista que você já tem.

Os termos

Valem para a API os mesmos termos que valem para as páginas, mais três coisas: ela não pode ser usada para jogos de azar, para assédio, nem para promover violência ou automutilação; os limites podem mudar sem aviso; e não há promessa nenhuma de nível de serviço, então não construa nada crítico em cima dela.

Termos

Versões e mudança

A versão fica no caminho. Uma mudança que quebraria quem chama sai como versão nova, e não como retoque nesta; e uma versão aposentada continua respondendo por pelo menos seis meses depois de a aposentadoria ser anunciada aqui. Campos novos podem aparecer numa resposta a qualquer momento, então leia com tolerância.

O servidor MCP

Um assistente que fala o Model Context Protocol consegue fazer tudo isso sem escrever HTTP por conta própria. O servidor responde num único endereço, uma mensagem por requisição, sem sessão para abrir ou fechar, e oferece quatro ferramentas: escolher um vencedor, montar times, publicar uma roleta e conferir um sorteio que outra pessoa fez. Ele gasta a mesma chave e as mesmas chamadas por dia que os endpoints, então nada do que você pode fazer muda conforme a porta pela qual você entra. Os nomes das ferramentas abaixo fazem parte do protocolo, por isso estão em inglês.

POST /mcp

pick_winner
make_teams
create_wheel
verify_draw

Referência

Cada endpoint, seus campos e as respostas que ele pode dar. A descrição da mesma coisa, legível por máquina, está num único arquivo:

/openapi.json

A referência dos endpoints está escrita em inglês.