Lista de errores de Midaz

{
   "type": "https://errors.lerian.studio/v1/<error_code>",
   "title": "<error_title>",
   "status": <http_status>,
   "detail": "<error_message>",
   "code": "<error_code>"
}

• type: Un URI que identifica el tipo de error, compuesto por https://errors.lerian.studio/v1/ seguido del código de error.
• title: Un resumen breve del problema.
• status: El código de estado HTTP de la respuesta.
• detail: Orientación detallada para resolver el error. La columna message de la tabla siguiente muestra el texto que devuelve la API. %v representa un valor que la respuesta completa.
• code: Un identificador único y estable para el error.
• entityType: La entidad con la que se relaciona el error (por ejemplo, Organization). Solo está presente cuando corresponde.

{
   "type": "https://errors.lerian.studio/v1/0009",
   "title": "Missing Fields in Request",
   "status": 400,
   "detail": "Your request is missing one or more required fields: [legalName]. Please refer to the documentation to ensure all necessary fields are included in your request.",
   "code": "0009",
   "entityType": "Organization",
   "errors": [
      { "location": "legalName", "message": "legalName is a required field" }
   ]
}

{
   "type": "https://errors.lerian.studio/v1/0047",
   "title": "Bad Request",
   "status": 400,
   "detail": "The server could not understand the request due to malformed syntax. Please check the listed fields and try again.",
   "code": "0047",
   "errors": [
      { "location": "legalName", "message": "legalName is a required field." },
      { "location": "parentOrganizationId", "message": "parentOrganizationId must be a valid UUID" }
   ]
}

{
   "type": "https://errors.lerian.studio/v1/0053",
   "title": "Unexpected Fields in the Request",
   "status": 400,
   "detail": "The request body contains more fields than expected. Please send only the allowed fields as per the documentation. The unexpected fields are listed in the fields object.",
   "code": "0053",
   "errors": [
      { "location": "unknownField", "message": "unexpected field", "value": "..." }
   ]
}

​

Errores de Midaz

​

Detalles de algunos códigos

• 0003 (409): el ledger ya tiene un activo con ese nombre o código. Cuando dos solicitudes crean un activo con el mismo código al mismo tiempo, solo una tiene éxito.
• 0020 (409): el ledger ya tiene una cuenta con ese alias. Cuando dos solicitudes crean una cuenta con el mismo alias al mismo tiempo, solo una tiene éxito.
• 0515 (400): la solicitud tiene más tramos de débito y de crédito de los que Midaz acepta. Una transacción o una reversión que registra más de 10.000 tramos recibe este código.
• 0542 (503): Midaz no puede leer el estado de un saldo, o Valkey rechaza la escritura de una transacción porque no tiene memoria. La solicitud no cambia nada. Repítela, con la misma clave de idempotencia en el caso de una escritura.

​

Rechazos de autenticación y de tenant