Errores e identificadores de correlación
Problem Details
Sección titulada «Problem Details»Los errores de la API pública usan respuestas tipo Problem Details con estado HTTP, código de dominio estable, ID de correlación y detalles de validación cuando corresponda. Usa el código y el estado para la lógica; presenta el título y detalle como texto para personas.
- 401: credencial ausente o no válida.
- 403: scope insuficiente o autorización de tenant denegada.
- 404: recurso ausente en el entorno autorizado.
- 409: conflicto de estado, idempotencia u operación concurrente.
- 422: regla de dominio o transición no permitida.
- 429: límite de solicitudes; respeta Retry-After cuando aparezca.
Correlación y reintentos seguros
Sección titulada «Correlación y reintentos seguros»Comparte el ID de correlación con soporte sin exponer secretos. Reintenta solo si el contrato de la operación y la certeza del resultado lo permiten. Corrige errores de validación en lugar de repetir la misma solicitud automáticamente.