Errores Y OpenAPI
Gestiona errores y genera clientes desde el schema OpenAPI.
Errores Estructurados
Los errores se devuelven como JSON.
{
"error": {
"code": "bad_request",
"message": "Invalid request.",
"retryable": false,
"context": {}
}
}
Códigos Comunes
| Código | Significado |
|---|---|
invalid_api_key | Key ausente, expirada o inválida. |
payment_required | El workspace no tiene plan de pago. |
insufficient_credits | No hay créditos suficientes para crear el trabajo. |
bad_request | Body, params u opción inválida. |
idempotency_conflict | La misma idempotency key se usó con otro payload. |
rate_limited | Demasiadas requests. |
not_found | El recurso no existe o pertenece a otro workspace. |
server_error | Fallo inesperado del servidor. |
GET /openapi.json
Devuelve el schema OpenAPI.
GET /skill.md
Devuelve un archivo Skill.md listo para agentes.