200 y un cuerpo de error. Las respuestas de error no se facturan. La llamada se registra igualmente y, en los proyectos Trial, cuenta para el límite mensual.
Formato de la respuesta de error
Encabezados de respuesta
X-Tx-Id no se envía en las solicitudes rechazadas antes de leer el cuerpo: JSON mal formado (400 REQUEST_INVALID) y cuerpo demasiado grande (413 REQUEST_TOO_LARGE). Al contactar con soporte, incluya X-Request-Id y X-Trace-Id junto con X-Tx-Id.
Códigos de error
Problemas de la solicitud (4xx)
La misma solicitud devuelve el mismo resultado hasta que la corrija. No la reintente tal cual.Problemas de la imagen de entrada (502)
El motor respondió con normalidad, pero no encontró lo que necesitaba en la imagen enviada. Enviar la misma imagen devuelve el mismo resultado, así que vuelva a llamar con una imagen capturada de nuevo.Problemas del servidor y de la fuente (5xx)
No los causa su solicitud. Reintente según las reglas siguientes.Dentro de
v1 se pueden añadir nuevos códigos de error. Si recibe un code desconocido, trátelo según su estado HTTP (4xx o 5xx).Llamadas duplicadas y reintentos
Unit API no acepta claves de idempotencia. Enviar la misma solicitud dos veces se procesa y se factura como dos llamadas.- Una llamada de la que no recibió respuesta, o que devolvió
504 UPSTREAM_TIMEOUT, puede haberse procesado. Antes de reintentar, compruebe si la llamada aparece en el historial de llamadas del panel.- Si recibió el encabezado
X-Tx-Id, busque por TX ID. - Si no, búsquela en la columna
referenceIddel CSV del historial de llamadas. Para ello, envíe unreferenceIddistinto en cada llamada.
- Si recibió el encabezado
- Limite los reintentos de 5xx a unos tres, con esperas crecientes. Ejemplo: tras 1, 2 y 4 segundos
- Los proyectos Trial cuentan las llamadas con error para el límite mensual, así que limite los reintentos todavía más.
Tiempo de respuesta
Las consultas a registros esperan la respuesta de la fuente y pueden tardar varios segundos. Por ejemplo, la verificación de la licencia de conducir puede tardar de 5 a 12 segundos. Configure un tiempo de espera del cliente amplio (60 segundos o más). Un tiempo de espera corto puede hacer que considere fallida una llamada ya procesada y la reintente, lo que la factura dos veces.Política de versiones
Elv1 de la ruta es la versión del contrato.
Cambios que se aplican en la misma versión: asegúrese de que los valores desconocidos no rompan su código.
- Nuevas API, nuevos campos de solicitud opcionales, nuevos campos de respuesta
- Un campo de solicitud obligatorio que pasa a ser opcional
- Nuevos valores de enum, nuevos
codede error, mejoras en la redacción demessage
v1 no se sobrescribe.
- Eliminar una API o cambiar una ruta o un método
- Añadir un campo de solicitud obligatorio o hacer obligatorio un campo opcional
- Eliminar o renombrar campos de respuesta; eliminar, renombrar o cambiar el significado de valores de enum o de
codede error - Cambiar tipos de campo, reglas de
null, condiciones de éxito o estados HTTP
agency y data.raw, quedan fuera de esta política. Pueden cambiar sin aviso cuando cambia la fuente o el motor.
Al contactar con soporte
Incluya los siguientes valores.- TX ID (
txIdoX-Tx-Id) X-Request-IdyX-Trace-Id- Hora de la llamada (UTC) y la API llamada
- El estado HTTP y el
coderecibidos