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

​
Proceso de solicitud

Para utilizar la API de verificación de dos factores 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; 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 el panel de control.
📘 Documentación completa: API de verificación de dos factores 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 mobile. A continuación, podemos completar el contenido correspondiente en la interfaz, como se muestra en la imagen:

Como puedes ver, 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 que necesita ser procesado, es un parámetro obligatorio.
  • mobile: el número de teléfono que necesita ser procesado, es un parámetro obligatorio.
  • encryption: opcional, parámetro de cifrado de campos sensibles (si se necesita enviar encriptado).
Después de seleccionar, puedes notar que también 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: El resultado de la verificación es consistente
      • 1: El resultado de la verificación no es consistente
    • Códigos de resultado sin cobro:
      • -1: No se encontraron registros
      • -2: Error desconocido del motor
      • -3: Excepción del servicio del motor
      • -4: Verificación del nombre no aprobada
      • -5: Número de teléfono no válido
      • -6: El número de intentos de autenticación ha superado 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 autenticidad y consistencia del número de teléfono y el nombre ya han sido consultadas. Además, si deseas generar el código de integración correspondiente, puedes copiarlo directamente, por ejemplo, el código 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 dos factores del número de teléfono para verificar la autenticidad y consistencia del número de teléfono y el nombre. 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.