API externa de SETTO
Una API HTTP de solo lectura que permite a un organizador llevar sus torneos, categorías, equipos, rondas, partidos y clasificaciones de SETTO a un sitio web, una hoja de cálculo o un agente de IA.
La API externa de SETTO es una API HTTP de solo lectura. Con un token de API de
organización puedes leer todos los torneos que pertenecen a tu organización de
SETTO — sus categorías (divisions), equipos, rondas, grupos, cuadros, partidos y
clasificaciones — y mostrarlos donde quieras. Son seis endpoints, todos GET,
todos bajo /v1/external/. Esta página explica qué cubre la API y a dónde ir
después; el inicio rápido tiene una petición funcionando
en menos de cinco minutos.
Qué puedes leer
| Recurso | Endpoint |
|---|---|
| La organización y el token detrás de la petición | GET /v1/external/me |
| Torneos que pertenecen a la organización | GET /v1/external/tournaments |
| Un torneo, con relaciones opcionales | GET /v1/external/tournaments/{idx} |
| Las categorías (divisions) de un torneo | GET /v1/external/tournaments/{idx}/divisions |
| Los equipos de un torneo y sus jugadores | GET /v1/external/tournaments/{idx}/teams |
| Una ronda: grupos, clasificación, partidos y cuadros | GET /v1/external/rounds/{idx} |
Esa es toda la superficie. No hay acceso de escritura: la API no puede crear un torneo, capturar un resultado ni inscribir a un jugador.
Para quién es
- Clubes y federaciones que integran cuadros, calendarios y clasificaciones en vivo en su propio sitio web.
- Patrocinadores y medios que extraen partidos y resultados para una gráfica de transmisión o un boletín.
- Analistas que exportan una temporada a una hoja de cálculo o una base de datos.
- Agentes de IA — cada página de aquí también se sirve como Markdown, y hay un servidor MCP y un Agent Skill para esos mismos seis endpoints.
URL base
https://api.setto.io/v1Cada ruta de esta documentación se escribe completa
(/v1/external/tournaments), así que se agrega directamente al host.
api.setto.io es el host canónico; el host generado por Railway al que
reemplazó sigue respondiendo, pero las integraciones nuevas no deben usarlo.
Autenticación en una línea
Envía el token de tu organización como bearer token en cada petición:
GET /v1/external/tournaments HTTP/1.1
Host: api.setto.io
Authorization: Bearer setto_live_YOUR_TOKEN_HERELos tokens se crean en el panel de organizador de SETTO y pertenecen a una organización, no a una persona. Consulta Autenticación.
Qué nunca devuelve la API
La API externa está diseñada para ser segura de poner frente a un sitio web
público. Nunca devuelve datos personales de contacto (ni correos, ni teléfonos,
ni redes sociales) ni datos de pago o facturación. Los objetos de jugador llevan
solo idx, firstName, lastName y avatar.
Hay dos cosas que sí devuelve y que suelen sorprender:
- Categorías y rondas ocultas. Regresan con
isVisible: falseen lugar de omitirse, así que tú decides si las muestras. - Torneos en borrador y archivados. Fíltralos con el parámetro de consulta
statussi solo quieres los que están en curso.
A dónde ir después
Inicio rápido
Crea un token y haz tus primeras tres peticiones.
Autenticación
Formato del token, alcance, rotación y 401 contra 403.
Modelo de datos
Torneo, categoría, ronda, grupo, cuadro, partido, equipo.
Referencia de la API
Referencia generada por endpoint con un panel Try it.
Guías
Un ejemplo resuelto por endpoint.
Para agentes de IA
llms.txt, Markdown por página, OpenAPI y MCP.