Referencia de la API

Las páginas de esta sección se generan desde el documento OpenAPI de la API externa de SETTO, así que no pueden desviarse de la API: una página por operación, con su ruta, su método, cada parámetro, el esquema de seguridad y el esquema de respuesta. Cada página lleva además un panel Try it que dispara una petición real desde tu navegador, para que veas un payload en vivo sin salir de la documentación. Si lo que buscas son ejemplos resueltos y consejos en lugar de una lista exhaustiva de parámetros, lee mejor las guías.

Las operaciones

Las páginas se agrupan por tag de OpenAPI — Organization, Tournaments, Divisions, Teams, Rounds, Scheduling, Activity — que es también el orden de la barra lateral.

Cómo usar "Try it"

Cada página de operación tiene un panel donde puedes llenar los parámetros de ruta y de consulta y enviar la petición.

1. Abre el campo Authorization y pega un token de API de SETTO, personal o de organización (setto_live_…). El panel usa el esquema bearer apiToken declarado en el spec.
2. Llena idx — un UUID real de torneo o de ronda que tu token alcance.
3. Envía. La respuesta regresa con su estado, sus cabeceras y su cuerpo.

Si una petición falla con un error de red o de CORS en lugar de un estado HTTP, el token nunca salió de tu navegador — revisa el token y la URL e inténtalo de nuevo.

El documento OpenAPI crudo

El mismo documento que genera estas páginas se publica en /openapi.json. Apunta ahí un generador de clientes, una importación de Postman o un agente de IA:

curl -s https://docs.setto.io/openapi.json -o setto-external-api.json

Su servers[0].url se llena al momento de la petición con la URL base de la API contra la que está configurado este sitio, así que las URLs de un cliente generado quedan correctas sin editar nada.

Relacionado

• Autenticación — antes de pegar un token en ningún lado.
• Errores — cada estado y código que lista la referencia.
• Límites de uso — las cabeceras que lleva cada respuesta.