Códigos de respuesta de la API — Referencia completa

Esta página es una referencia completa de todos los códigos de respuesta devueltos por las APIs de DQE, tanto errores a nivel HTTP como códigos de validación específicos de cada servicio. Utilice las secciones siguientes para buscar cualquier código que reciba.

• Errores HTTP — comunes a todas las APIs
• Email API
• Phone API
• Address API — CheckAddress (DQECodeDetail)
• Geocoding API (CodeQualiteGeo)
• B2B API
• SMS Phone Confirmation API
• ID Mobile API

Errores HTTP — comunes a todas las APIs

Estos errores se producen a nivel de transporte HTTP y son comunes a todos los servicios API de DQE.

APIs Classic

APIs Restful

Las APIs Restful devuelven objetos de error JSON estructurados con el siguiente formato:

{
  "status": 400,
  "message": "Missing parameters",
  "details": "Licence",
  "error": "bad request"
}

Email API

Devuelto por Email API — Validate an email address (Classic) y Restful Email API — email/lookup.

Códigos IdError

El campo IdError es el resultado de validación principal de cada solicitud de email.

Códigos CodeActivite (verificación de nivel 2)

Se devuelven solo cuando la verificación de nivel 2 está habilitada. M = mes actual.

Phone API

Devuelto por Phone API — Classic y Restful Phone API — phonelookup.

Códigos IdError

Códigos Status (verificación de nivel 2 — API Classic)

Se devuelven cuando se establece Status=Y en la solicitud. Solo para números de móvil franceses.

Address API — CheckAddress (DQECodeDetail)

Devuelto por Address API — Check and verify an address (Classic) y Address API — Check and verify an address (RESTful). El campo DQECodeDetail (Classic) / DQEDetailCode (RESTful) indica la puntuación de calidad de la validación de la dirección. Los mensajes de interfaz sugeridos proceden de la Address API — Integration guide.

Guía rápida de interpretación: Los códigos 10, 20, 25 indican que la dirección es válida. El código 90 indica una dirección internacional, con discrepancia de código de país — verifíquela. Los códigos 21–24 indican un problema con el número. Los códigos 30–61 indican un problema con la vía (excluyendo los códigos en desuso 40/60). El código 70 indica discrepancia entre código postal y ciudad, con la vía presente. El código 80 indica discrepancia entre código postal y ciudad, sin la vía. El código 81 indica una entrada vacía. El código 95 indica un país incorrecto. Los códigos 40, 60 y 71 están en desuso — se mantienen únicamente por compatibilidad.

Geocoding API (CodeQualiteGeo)

Devuelto por Geocoding API — Get GPS coordinates y por CheckAddress cuando Version=1.1. El campo CodeQualiteGeo indica el nivel de precisión de las coordenadas geográficas.

Nota: Cuando falta el parámetro Licence o no es válido, la Geocoding API devuelve Latitude: "0.00" y Longitude: "0.00" en lugar de un error HTTP.

B2B API

Devuelto por B2B Classic API — RECSIRET, B2B Classic API — SIRETINFO, Restful B2B API — Lookup, y Restful B2B API — GetInfo.

DQE_status (API Classic — formato extendido de SIRETINFO)

CompanyStatus

MainCompanyFlag

SMS Phone Confirmation API

Devuelto por SMS Phone Confirmation API — Send OTP (GDPR_MSG) y SMS Phone Confirmation API — Verify OTP (GDPR_VERIF).

GDPR_MSG — estado de entrega del SMS

GDPR_MSG — códigos de error (campo errors)

GDPR_VERIF — códigos de error (campo errors)

ID Mobile API

Devuelto por todos los scopes de ID Mobile: Simswap, Matching without OTP, Number Verify, Formfilling, y Billing.

Los errores se devuelven como un objeto JSON con tres campos: status (error), error_id y error_type.

{
  "status": "error",
  "error_type": "invalid phone number",
  "error_id": "10"
}

Códigos de error del paso 1 — todos los scopes

Estos códigos de error los devuelve la primera llamada a la API (endpoint /IDMOBILE/) para todos los scopes.

Códigos de error del paso 2 — Number Verify, Formfilling, Billing

Estos códigos de error adicionales los devuelve la llamada de recuperación (endpoint /GET/) después de que el usuario haya completado la redirección del operador.