Construa sobre o Sporfie
Uma API REST e um servidor MCP para os eventos, vídeos e transmissões em direto que a sua organização já gere no Sporfie. Crie eventos a partir do seu sistema de reservas, envie resultados em direto, corte highlights, receba webhooks — ou pergunte simplesmente ao seu assistente de IA.
Funciona nas ferramentas de IA que já usa
O Sporfie disponibiliza um servidor MCP que expõe a API pública como 19 ferramentas selecionadas. Ligue-o uma vez e pergunte em linguagem natural. Cada chamada a uma ferramenta é uma chamada normal à API — mesmos identificadores, mesmas permissões, mesmos limites.
- Claude
- ChatGPT
- Grok Bot
- Cursor
- e qualquer outro cliente compatível com MCP
Transporte Streamable HTTP. As ferramentas do centro de ajuda funcionam sem token.
Ligação com um clique
Adicione o servidor sem cabeçalho e o seu cliente executa o fluxo OAuth padrão do MCP: inicie sessão no Sporfie uma vez, aprove a ligação e está feito. Nenhuma chave para copiar.
Ou use a sua própria chave
Para CLI, CI e scripts, crie uma chave pessoal em Definições → Programador e passe-a como cabeçalho Bearer. A mesma chave também serve para chamadas REST diretas.
Gerir chaves APIO que as ferramentas cobrem
Criar, ler, atualizar, fechar e eliminar eventos · pesquisa e evento em curso · locais e desportos · momentos em destaque · webhooks de evento · pesquisa no centro de ajuda.
Pergunte em vez de integrar
Três conversas que usam apenas ferramentas que o servidor MCP do Sporfie realmente expõe.
Feito — li 6 jogos na foto e agendei-os nos seus campos com câmara:
- Sáb 09:00 · U14 Tigers – Falcons · Campo 1
- Sáb 10:30 · U16 Tigers – Ravens · Campo 1
- Sáb 12:00 · U19 Tigers – Bulls · Campo 2
- + 3 no domingo
Cada um grava e transmite automaticamente quando começa. Quer que adicione um webhook para o seu site se atualizar quando entrarem em direto?
Eis o que encontrei sobre a final da Spring Cup (26 abr, Campo 1):
O mais visto: o match point aos 2:31:07, com 412 visualizações.
As visualizações são contadas por clip em destaque. A API não reporta espectadores da transmissão em direto.
A final U19 está agendada para sábado das 14:00 às 16:00 no Campo 2, portanto o evento está pronto. Os URL RTMP são atribuídos por codificador dentro do Sporfie, não através da API. O caminho mais rápido:
- Abra Definições → Codificadores e adicione a sua GoPro (ou selecione-a).
- Copie o URL RTMP para a app GoPro.
- Ou mostre o código QR GoPro e leia-o com a câmara — o stream configura-se sozinho.
Conversas ilustrativas. A redação varia consoante o assistente; as chamadas às ferramentas são reais.
O que pode construir
Tudo o que se segue está hoje na especificação OpenAPI pública — nada de roadmap.
Eventos com os seus IDs
Crie, atualize, feche e elimine eventos. Refira-se a eles pelo seu próprio externalID para que o seu sistema continue a ser a fonte de verdade.
Gravação agendada
Associe um evento a um local com câmaras, com hora de início e fim, e ele grava e transmite sozinho.
Resultados em direto
Envie um fluxo de pontuação a partir da sua app ou dispositivo; o marcador e o evento acompanham.
Highlights a pedido
Registe um clique num instante e o Sporfie corta um clip à volta — a partir de um botão, um sensor ou da sua própria lógica.
Webhooks
Acompanhe um evento e receba o objeto completo a cada alteração. Prefira-o ao polling.
Momentos, reels e marcadores
Leia os URL dos clips e as visualizações, faça a gestão de reels e coleções de marcadores, exporte clips etiquetados.
Incorpore o player
O player do Sporfie integra-se em qualquer página como um iframe.
Cinco chamadas cobrem a maioria das integrações
Diretamente da documentação. Defina SPORFIE_TOKEN, COMPANY_KEY e PLACE_KEY no seu ambiente e correm tal como estão.
curl -X POST "https://api.sporfie.com/public/events/booking-48213" \
-H "Authorization: Bearer $SPORFIE_TOKEN" \
-H "Content-Type: application/json" \
-d @- <<JSON
{
"companyKey": "$COMPANY_KEY",
"name": "U16 semi-final",
"sport": "volleyball",
"homeTeam": "Tigers",
"awayTeam": "Falcons",
"placeKey": "$PLACE_KEY",
"scheduledStartTime": 1757683200000,
"scheduledEndTime": 1757690400000
}
JSON
# → { "eventKey": "-Nq7xK2mBv9pL3aRt8Zc" }›Verifique primeiro a sua chave
curl -o /dev/null -w '%{http_code}\n' \
-H "Authorization: Bearer $SPORFIE_TOKEN" \
https://api.sporfie.com/public/sports
# 200 means the key works. 401 means it doesn't.Como funciona o acesso
Crie uma chave pessoal
Em Definições → Programador. O segredo é mostrado uma só vez — guarde-o num gestor de segredos.
Age em seu nome
Uma chave alcança as organizações que administra e pode ser restringida a algumas na criação. Cada chamada é verificada face à sua pertença atual.
Chame a API ou ligue o MCP
REST em api.sporfie.com, ferramentas em mcp.sporfie.com — mesma chave, mesmo âmbito, mesmos limites.
Precisa de gerir organizações que não administra? Isso requer uma chave de integração emitida pelo Sporfie.
Fale connoscoBom saber
- Cerca de 1 pedido por segundo por chave. Distribua o trabalho em massa e abrande perante um 429.
- Todos os tempos são milissegundos UTC desde a época Unix.
- Os watches de evento expiram após 12 horas — volte a registá-los periodicamente.
- Um clique é aceite, não concluído: os clips demoram alguns segundos. Consulte o momento se precisar do ficheiro.
- As chaves ficam no servidor. Nunca num browser, numa app móvel ou num repositório.
Comece a construir
A referência completa, a especificação OpenAPI e um guia escrito para agentes de IA estão em docs.sporfie.com.
Guia para agentes de IA