Errores y límites

Todos los errores tienen la misma forma y un código HTTP estable. Los límites protegen a todos los usuarios de la API.

Formato

json
{ "error": "prices es obligatorio si el evento no es gratis" }

El mensaje está en español y es legible: muéstralo o regístralo tal cual. Para decidir qué hacer, usa el código.

Códigos

CódigoSignificaQué hacer
400Regla del evento no cumplida (de pago sin precios, fin antes del inicio, moneda o zona no válida…)Corrige los datos; no reintentes igual
401Clave o token ausente, inválido o revocado, o quien la creó ya no gestiona la empresaRevisa la cabecera Authorization o crea otra clave
403Falta el scope (La clave no tiene el permiso events:write)Crea una clave o pide un token con ese permiso
404El recurso no existe, es de otra empresa o de otro modo (live/test)No se distingue a propósito
409Conflicto: externalId ya existe en POST, entradas ya vendidas en un precio que quitas, límite de claves o webhooksUsa el upsert o ajusta el cambio
413Imagen demasiado grandeHasta 10 MB
422Formato inválido: falta un campo obligatorio, tipo incorrecto, dirección no encontrada o póster que no se pudo descargarCorrige los datos
429Demasiadas peticionesEspera y reintenta con backoff
5xxError nuestroReintenta con backoff; el upsert es idempotente

Los errores de OAuth siguen el RFC 6749 (invalid_client, invalid_grant…); los ves en Autenticación.

Límites

QuéLímite
Peticiones a /v1 y al MCP60 por minuto por clave o por permiso OAuth
GET /v1/eventslimit hasta 100
GET /v1/events/:id/ticketslimit hasta 500
PóstersJPG, PNG o WebP, hasta 10 MB
Claves de API activas2 (gratis) o 10 (PRO) por empresa
Webhooks10 por empresa
Feeds10 por empresa; archivos hasta 3 MB
Apps OAuth10 por persona
Eventos de pruebaSe borran a los 7 días
Access token OAuth1 hora; refresh token, 90 días

Reintentos recomendados