Solución de problemas

En está sección encontraras solución a errores comunes, adémas de una lista con las diferentes rutas y los errores de validación que puede devolver.

Petición no válida (InvalidRequestBody / InvalidQueryParameters)

{
  "success": false,
  "statusCode": 400,
  "error": "InvalidRequestBody",
  "environment": "stage",
  "properties": {
    "errors": [
      { "property": "validationRequired", "rules": ["isBoolean"], "message": "validationRequired must be a boolean value" }
    ]
  }
}

Algún campo del cuerpo o de la query no tiene el tipo esperado (por ejemplo, un booleano enviado como texto o una fecha con otro formato). properties.errors indica cada campo y la regla que no cumple; nunca incluye los valores enviados. Revisa el tipo de cada campo en la referencia de la API.


Errores de Blindaje

{
  "type": "limits",
  "error": "NotAvailableShield1"
}

Solución: Adquirir más blindajes.


Access Denied

{
  "success": false,
  "statusCode": 401,
  "error": "Unauthorized",
  "environment": "production",
  "code": "INVALID_CREDENTIALS",
  "hint": "Credencial ausente o no válida en este entorno (Producción). ...",
  "docs": "https://developer.trato.io/entornos"
}

Si la respuesta trae "code": "INVALID_CREDENTIALS", lo más habitual es una credencial de otro entorno: una API key de Stage contra la URL de Producción o al revés. El campo environment indica qué entorno ha respondido. Usa la URL base y la credencial del mismo entorno (ver la página Entornos).

Solución: Verifica que el apiKey o el JWT sean correctos, para usar el JWT, agrega el header: 'Authorization: bearer JWT', como en el siguiente ejemplo:

    fetch(url, {
        method: 'GET'
        body,
        headers:{
            'Authorization': 'bearer iOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2'
        }
    })

O si usas el apikey:

   fetch(url, {
        method: 'GET'
        body,
        headers:{
            'apikey': 'apikey aqui'
        }
    })

Si usas una herramienta para crear peticiones sobre APIs (como Postman), agrega los encabezados en la sección de Headers

    key: Authorization
    value: bearer iOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2
ó
    key: apikey
    value: apikey aqui

Credenciales Incorrectas

En caso de tener habilitada dicha protección en el TENANT, lo que cambia es como se obtiene el contenido de los archivos, por lo que con esto es necesario tener una sesión válida, por lo que nadie que no este autorizado podrá obtener el

{
  "success": false,
  "statusCode": 400,
  "error": "Account email is required in order to process this request."
}

Solución: Para hacer la llamada para generar el jwt, verifica que las llaves del objeto esten escritas de forma correcta, como en el siguiente ejemplo:

{
  "email": "myuser@mydomain.com",
  "password": "mypassword"
}