Errores comunes de la API y cómo resolverlos
Al integrar la API es normal toparse con códigos de error. Casi todos se resuelven en minutos una vez que sabes qué significan.
En esta guía repasamos los errores más comunes —401, 404, 429 y errores de formato— y la forma de corregir cada uno.
Errores de autenticación y permisos
- 401 No autorizado: tu API key falta, está mal escrita o fue revocada. Verifica que la envías en la cabecera correcta y que sigue activa.
- Si rotaste tu key, actualízala en todos los entornos donde la uses.
Recurso no encontrado y límites
- 404 No encontrado: la URL del endpoint es incorrecta o el identificador consultado no existe. Revisa la ruta y el valor enviado.
- 429 Demasiadas peticiones: superaste el límite de peticiones por minuto. Espera y reintenta con un backoff, o escríbenos si necesitas más capacidad.
Errores de formato
Muchos errores no son del servidor, sino del dato enviado. Una cédula debe tener 10 dígitos, un RUC 13 y una placa el formato correcto.
Valida el identificador antes de enviarlo y revisa que el cuerpo de la petición sea JSON bien formado.
¿Listo para hacer la consulta?
Ver la documentación de la APIPreguntas frecuentes
¿Por qué recibo un error 401?+
Casi siempre porque la API key falta, está mal escrita o fue revocada. Verifica que la envías en la cabecera de autorización y que sigue activa.
¿Cómo evito el error 429?+
El 429 indica que superaste el límite de peticiones por minuto. Reintenta con un backoff progresivo o escríbenos si necesitas más capacidad.