O XispeScore publica uma superfície de integração somente leitura para dados esportivos que já são públicos na plataforma. Agentes e aplicações podem descobrir essa superfície por URLs previsíveis, sem depender de scraping da interface visual. A especificação OpenAPI 3.1 é a fonte de verdade para os endpoints REST públicos, parâmetros, códigos de resposta e esquemas de dados.

A API pública inclui descoberta do produto e consulta de competições publicadas. Respostas de erro usam JSON estruturado com código estável, mensagem legível e uma dica de resolução, enquanto o status HTTP continua sendo a autoridade sobre sucesso ou falha. Endpoints administrativos, áreas autenticadas e rotas internas não fazem parte da API pública e não devem ser usados por integrações externas.

Os endpoints REST públicos usam versão principal na URL, atualmente /api/public/v1/.... A política de versionamento explica quando uma nova versão principal é necessária, como o XispeScore publicará Deprecation e Sunset e quais cabeçalhos de rate limit agentes devem observar. A versão v1 não está atualmente depreciada.

Para clientes compatíveis com Model Context Protocol, o XispeScore publica um endpoint MCP Streamable HTTP em /.well-known/mcp. Ele aceita o protocolo moderno 2026-07-28 com descoberta server/discover e mantém compatibilidade com clientes legados de 2025-11-25. As ferramentas expostas são somente leitura.

Agentes devem preferir a especificação OpenAPI quando precisam gerar chamadas REST ou function calling e devem preferir MCP quando o cliente oferece suporte nativo ao protocolo. Os arquivos /llms.txt, /llms-full.txt e /agent.txt descrevem quando usar o XispeScore, quais recursos são públicos e como recuperar de caminhos inexistentes.

Recursos

• XispeScore OpenAPI 3.1
• XispeScore Public API index
• XispeScore public competitions API
• XispeScore API versioning, deprecation and rate limits
• Machine-readable API lifecycle policy
• XispeScore MCP endpoint
• XispeScore llms.txt · agent.txt

Para dúvidas de integração, use o canal oficial de contato. Consulte também Sobre o XispeScore e Privacidade.