Errores

Help Center

Improved

Maintenance update

Promotional

Service

Mobile

grou

In Review

Planned

In Progress

Completed

Rejected

High Priority

Low Priority

Backlog

Next up

Done

Main Roadmap

Hey {name|there}! 👋

Feedback

Roadmap

Changelog

How can we help you?

Crea, edita y publica tus programas, talleres y checkouts desde tu plataforma o un agente de IA.

API para mentores

API para mentores de Grou

Introducción a la API para mentores

Guías

<p>Todos los errores tienen la misma forma:</p><p></p><pre><code>{
  "error": "validation_failed",
  "category": "validation",
  "message": "El taller requiere fecha de inicio",
  "issues": [
    { "path": "content.start_date", "message": "required" }
  ]
}</code></pre><p></p><table><thead><tr><th>Campo</th><th>Descripción</th></tr></thead><tbody><tr><td><code>error</code></td><td>Código estable, apto para lógica en tu código</td></tr><tr><td><code>category</code></td><td><code>permission</code>, <code>validation</code>, <code>state</code> o <code>internal</code></td></tr><tr><td><code>message</code></td><td>Descripción legible</td></tr><tr><td><code>issues</code></td><td>Opcional: lista de campos con problema (<code>path</code> + <code>message</code>)</td></tr></tbody></table><p></p><h2 id="cdigoshttp">Códigos HTTP</h2><p></p><table><thead><tr><th>HTTP</th><th>Categoría</th><th>Ejemplo</th></tr></thead><tbody><tr><td><code>400</code></td><td>validation</td><td>JSON mal formado (<code>invalid_json</code>); campo faltante o inválido, campo desconocido o <code>id</code> de contenido ajeno (<code>validation_failed</code>)</td></tr><tr><td><code>401</code></td><td>permission</td><td>Falta la API Key (<code>unauthorized</code>) o es inválida o fue revocada (<code>invalid_api_key</code>)</td></tr><tr><td><code>404</code></td><td>state</td><td>El recurso no existe, no es tuyo o no corresponde al tipo de la ruta (<code>not_found</code>)</td></tr><tr><td><code>422</code></td><td>validation</td><td>El request es válido pero una regla del producto lo impide: falta algo para publicar, slug ya usado, coproducción inválida… (<code>unprocessable</code>)</td></tr><tr><td><code>500</code></td><td>internal</td><td>Error inesperado de nuestro lado (<code>internal_error</code>); puedes reintentar</td></tr></tbody></table><p></p><p>Consejo: usa <code>error</code> y <code>category</code> para decidir qué hacer en tu integración, y <code>message</code> / <code>issues</code> para mostrarle el problema a una persona.</p>

Formato uniforme de errores y códigos HTTP de la API para mentores.

Campo	Descripción
`error`	Código estable, apto para lógica en tu código
`category`	`permission`, `validation`, `state` o `internal`
`message`	Descripción legible
`issues`	Opcional: lista de campos con problema (`path` + `message`)

HTTP	Categoría	Ejemplo
`400`	validation	JSON mal formado (`invalid_json`); campo faltante o inválido, campo desconocido o `id` de contenido ajeno (`validation_failed`)
`401`	permission	Falta la API Key (`unauthorized`) o es inválida o fue revocada (`invalid_api_key`)
`404`	state	El recurso no existe, no es tuyo o no corresponde al tipo de la ruta (`not_found`)
`422`	validation	El request es válido pero una regla del producto lo impide: falta algo para publicar, slug ya usado, coproducción inválida… (`unprocessable`)
`500`	internal	Error inesperado de nuestro lado (`internal_error`); puedes reintentar