API — Sem Firula

Para que serve

A pelada vive no grupo do WhatsApp, e a gente sabe disso. Esta API existe para você levar os dados até lá: um bot que responde “quem confirmou pra quinta?”, um placar no site do time, uma planilha que se atualiza sozinha. Você não precisa da nossa permissão nem avisar ninguém — é público do mesmo jeito que a página é.

O básico

Base: https://gestao.semfirula.com/api/v1
Só GET. Não existe escrita — veja o porquê no fim.
Resposta em JSON, UTF-8. Datas em ISO 8601, sempre em UTC (terminam em Z).
Dinheiro em centavos inteiros: 2000 é R$ 20,00.
Organização inexistente responde 404 com {"erro": "não encontrado"}.
Limite de 120 chamadas por minuto por IP. Passou disso, 429.
CORS liberado: dá para chamar direto do navegador, de qualquer site.

Rotas

Rota	O que devolve
`/org/{slug}`	Nome, cores, esporte e os rankings (artilharia, assistências… o que existir no esporte)
`/org/{slug}/jogadores`	O elenco ativo com a estatística de cada um
`/org/{slug}/jogador/{slug}`	Um jogador
`/org/{slug}/eventos`	O que vem pela frente. `?passados=1` traz os que já aconteceram
`/org/{slug}/evento/{slug}`	Um evento com quem confirmou — a pergunta do grupo
`/org/{slug}/partidas`	As últimas partidas com placar e escalação
`/org/{slug}/partida/{codigo}`	A súmula de uma partida

Um exemplo

curl https://gestao.semfirula.com/api/v1/org/pelada-do-ze/eventos

{
  "organizacao": "pelada-do-ze",
  "eventos": [
    {
      "slug": "pelada-de-quinta",
      "nome": "Pelada de quinta",
      "local": "Quadra do Parque",
      "comeca_em": "2026-08-13T23:00:00Z",
      "preco_centavos": 2000,
      "situacao": "open"
    }
  ]
}

Cada esporte tem os seus números

Um jogador de vôlei tem aces onde o de futebol tem goals — e nenhum dos dois carrega o campo do outro. Em vez de chutar os nomes, leia esporte.estatisticas em /org/{slug}: ele lista as chaves que aquela organização usa, com o rótulo em português. Num esporte cooperativo, como o frescobol, tem_vencedor vem false e o placar é null — porque ali ninguém ganha, e inventar um vencedor seria pior que não ter.

O que ela não faz, e por quê

Não dá para escrever. Nem criar jogador, nem confirmar presença, nem lançar gol. Isso precisa de token por organização, com escopo, revogação, uma tela para criar e apagar, e registro de uso — senão vira uma porta dos fundos sem tranca para os mesmos dados que o formulário protege. É uma funcionalidade inteira, não uma rota, e meia dela seria pior que nenhuma.

E ela não devolve nada privado. Nem telefone, nem e-mail, nem quem está devendo, nem as anotações do administrador. A lista de inscritos traz nome, apelido e a vaga — o mesmo que qualquer visitante já vê na página do evento. Quem deve para a organização é assunto entre a pessoa e quem organiza.

Construiu alguma coisa com isto? Conta pra gente em gestao@semfirula.com — dá vontade de ver.