Lista de errores de STA

Formato de error Excepto por las respuestas de idempotencia, Lerian STA devuelve los errores como problem details de RFC 9457 con el tipo de medio application/problem+json:

{
  "code": "STA-0016",
  "detail": "The requested route does not exist on this service.",
  "status": 404,
  "title": "Not Found",
  "type": "https://errors.lerian.studio/v1/STA-0016"
}

Definiciones de campos

type – Un URI que identifica el error en el catálogo de errores de Lerian, construido como https://errors.lerian.studio/v1/<code>. Una respuesta sin code lleva el valor predeterminado de RFC about:blank.
title – El texto del estado HTTP (por ejemplo, Not Found).
status – El código de estado HTTP.
detail – Una explicación legible de esta ocurrencia. Una causa interna no queda en el cuerpo de la respuesta. Decide la rama con code en su lugar.
code – Un identificador estable para el error (STA-NNNN, o IDEMPOTENCY_KEY_REUSE para una clave de idempotencia reutilizada). Decide la rama con este campo. Una solicitud que falla la validación del esquema de la solicitud no lleva code, y errors nombra los campos responsables. Dos errores pueden compartir un title y un estado y aun así diferir aquí. STA-0005 y STA-0016 responden ambos 404 con el título Not Found. El code te dice cuál obtuviste.
errors – Lista opcional de detalles de error individuales, cada uno con una location, un message y un value.

Errores de solicitud y de enrutamiento

Estos errores se aplican a la solicitud misma. Cubren su sintaxis, sus campos, su ruta y el estado del servicio que la recibió.

`code`	Descripción	Estado
STA-0001	Solicitud incorrecta. El servicio no pudo leer la sintaxis de la solicitud, o el header `X-Idempotency` falta o tiene más de 256 bytes.	400
STA-0002	Error interno del servidor. Una falla inesperada. El `detail` dice `internal error`.	500
STA-0003	No autorizado. El recurso requiere autenticación.	401
STA-0004	Prohibido. El emisor de la llamada no tiene permiso para este recurso.	403
STA-0005	No encontrado. La ruta existe, y el recurso solicitado no.	404
STA-0006	Entidad no procesable. El servicio leyó la solicitud y no puede procesarla en su forma actual.	422
STA-0007	Conflicto. La solicitud entra en conflicto con el estado actual del recurso.	409
STA-0008	Servicio no disponible. Una dependencia que la solicitud necesita no está disponible. Intenta de nuevo más tarde.	503
STA-0009	Demasiadas solicitudes. Llegaron demasiadas solicitudes en un período dado.	429
STA-0010	Entidad de solicitud demasiado grande. El cuerpo de la solicitud, o el archivo que referencia una nueva transferencia, es más grande de lo que acepta Lerian STA.	413
STA-0011	Solicitud incorrecta. El código de reserva para un rechazo del lado del cliente sin una entrada dedicada.	400
STA-0012	Campos faltantes en la solicitud. Uno o más campos obligatorios están vacíos.	400
STA-0014	Campos de solicitud no válidos. Uno o más campos suministrados fallan la validación.	400
STA-0016	Ruta no encontrada. La ruta de la solicitud no coincide con ninguna ruta montada. Corrige la URL, porque un reintento da el mismo resultado.	404
STA-0017	Método no permitido. La ruta coincide con una ruta montada, y el método no. Cuando el enrutador rechaza el método, la respuesta lleva un encabezado `Allow` que enumera los métodos que la ruta acepta.	405

Errores de credenciales y de transferencia

Estos errores se aplican a las credenciales de BACEN, a la configuración de la fuente entrante y a la credencial bajo la cual se envía una transferencia.

`code`	Descripción	Estado
STA-0102	Conflicto. Una solicitud de rotación apunta a una credencial que no está activa.	409
STA-0103	Conflicto de código de institución. Ya existe una credencial activa para el mismo código de institución.	409
STA-0104	Presupuesto de polling superado. La configuración de la fuente entrante llevaría la reserva de descubrimiento entrante de la institución más allá de su tope de consultas por minuto.	422
STA-0105	Credencial predeterminada no resoluble. La solicitud omite `credentialId`, y Lerian STA no tiene una credencial elegible a la cual resolver.	422
STA-0106	Credencial predeterminada ambigua. Coincide más de una credencial elegible, así que el servicio se niega en lugar de elegir una. Nombra la credencial que quieres.	422
STA-0107	Credencial de institución no encontrada. El `institutionCode` suministrado no coincide con ninguna credencial elegible.	422

Respuestas de idempotencia

La creación de transferencias (POST /v1/transfers) y la consulta manual entrante (POST /v1/inbound-source-configs/{id}/trigger-poll) necesitan un header X-Idempotency. En estas dos operaciones, Lerian STA envía las respuestas siguientes como application/json. El cuerpo lleva code (el estado HTTP como número), title y message. Decide la rama con title.

`title`	Descripción	Estado
IDEMPOTENCY_CONFLICT	Una solicitud con la misma clave está en curso. Reintenta cuando termine.	409
IDEMPOTENCY_KEY_REUSE	La clave pertenece a una solicitud diferente. Revisa la primera solicitud antes de usar una clave nueva.	422
IDEMPOTENCY_OUTCOME_UNRECORDED	Una solicitud anterior con la misma clave respondió con `X-Idempotency-Fenced: true`. Lerian STA rechaza la clave durante 7 días. Revisa la primera solicitud.	422
IDEMPOTENCY_STATE_UNRECOGNISED	El registro almacenado de la clave tiene un estado que Lerian STA no conoce. Revisa la primera solicitud.	422
IDEMPOTENCY_RECORD_UNREADABLE	Lerian STA no puede leer el registro almacenado de la clave. Revisa la primera solicitud.	422
IDEMPOTENCY_UNFENCED	La solicitud se ejecutó, y la clave no está protegida. Una repetición puede ejecutar la operación de nuevo. Revisa la primera solicitud antes de enviar algo con esta clave.	503

Credenciales

Configuraciones de fuentes entrantes

Transferencias

Auditoría

Manejo de errores

Lista de errores de STA

Errores de solicitud y de enrutamiento

Errores de credenciales y de transferencia

Respuestas de idempotencia

​Errores de solicitud y de enrutamiento

​Errores de credenciales y de transferencia

​Respuestas de idempotencia

Errores de solicitud y de enrutamiento

Errores de credenciales y de transferencia

Respuestas de idempotencia