Skip to main content
Este documento presentará una verificación de los tres elementos del número de teléfono API, que se puede utilizar para verificar la autenticidad y consistencia del número de teléfono, nombre y número de identificación.

​
Proceso de solicitud

Para utilizar la API de verificación de los tres elementos del número de teléfono, primero dirígete a Ace Data Cloud Console para obtener tu API Token, que debes guardar como respaldo. Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invitará a registrarte e iniciar sesión, y una vez completado, volverás automáticamente a la página actual. Un API Token es suficiente para acceder a todos los servicios de la plataforma, no es necesario solicitar uno por cada servicio. La primera solicitud incluirá un crédito gratuito para que puedas probarlo; si el crédito es insuficiente, puedes recargar el saldo general en la consola.
📘 Documentación completa: API de verificación de los tres elementos del número de teléfono →

​
Uso básico

Primero, debes entender la forma básica de uso, que consiste en ingresar el número de teléfono para obtener el resultado procesado, primero necesitas pasar un campo phone. A continuación, puedes completar el contenido correspondiente en la interfaz, como se muestra en la imagen:

Puedes ver que aquí hemos configurado los Request Headers, que incluyen:
  • accept: el formato de respuesta que deseas recibir, aquí se establece como application/json, es decir, formato JSON.
  • authorization: la clave para llamar a la API, que puedes seleccionar directamente después de solicitarla.
Además, se ha configurado el Request Body, que incluye:
  • name: el nombre del usuario a procesar, es un parámetro obligatorio.
  • phone: el número de teléfono a procesar, es un parámetro obligatorio.
  • id_card: el número de identificación del usuario a procesar, es un parámetro obligatorio.
  • verify_mode: modo de verificación (versión larga/corta).
  • encrypt_list/ciphertext_blob/iv: parámetros de cifrado opcionales, para cifrar campos sensibles según sea necesario.
Después de seleccionar, puedes notar que se ha generado el código correspondiente a la derecha, como se muestra en la imagen:

Haz clic en el botón “Try” para realizar la prueba, como se muestra en la imagen anterior, aquí hemos obtenido el siguiente resultado:
El resultado devuelto tiene varios campos, que se describen a continuación:
  • result, código de resultado de autenticación, la situación de cobro es la siguiente.
    • Códigos de resultado de cobro:
      • 0: Resultado de verificación consistente
      • 1: Resultado de verificación inconsistente
    • Códigos de resultado sin cobro:
      • -1: Sin registros encontrados
      • -2: Error desconocido del motor
      • -3: Servicio del motor anómalo
      • -4: Verificación de nombre no aprobada
      • -5: Número de teléfono no válido
      • -6: Número de intentos de autenticación excede el límite diario, por favor intenta de nuevo al día siguiente
  • description, descripción del resultado del negocio.
Se puede ver que la información sobre la autenticidad y consistencia del número de teléfono, nombre y número de identificación ya ha sido consultada. Además, si deseas generar el código de integración correspondiente, puedes copiarlo directamente, por ejemplo, el código de CURL es el siguiente:
El código de integración en Python es el siguiente:

​
Manejo de errores

Al llamar a la API, si encuentras un error, la API devolverá el código de error y la información correspondiente. Por ejemplo:
  • 400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 401 invalid_token: No autorizado, token de autorización inválido o faltante.
  • 429 too_many_requests: Demasiadas solicitudes, has superado el límite de tasa.
  • 500 api_error: Error interno del servidor, algo salió mal en el servidor.

​
Ejemplo de respuesta de error

​
Conclusión

A través de este documento, ya has comprendido cómo utilizar la API de verificación de los tres elementos del número de teléfono para verificar la autenticidad y consistencia del número de teléfono, nombre y número de identificación. Esperamos que este documento te ayude a integrar y utilizar mejor esta API. Si tienes alguna pregunta, no dudes en contactar a nuestro equipo de soporte técnico.