Skip to main content
Este documento presentará una forma de integración de la API de consulta de estado de número de teléfono, que se puede utilizar para verificar el estado de un número de teléfono móvil, puede ingresar el número de teléfono para realizar la consulta.

​
Proceso de solicitud

Para utilizar la API de consulta de estado de número de teléfono, primero dirígete a Ace Data Cloud Console para obtener tu API Token, guárdalo para uso futuro. 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 invita a registrarte e iniciar sesión, una vez completado, serás redirigido 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, que te permitirá experimentar sin costo; si el crédito es insuficiente, puedes recargar el saldo general en la consola.
📘 Documentación completa: API de consulta de estado de 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, y así 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 solicitar.
Además, se ha configurado el Request Body, que incluye:
  • 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: Éxito
    • Códigos de resultado sin cobro:
      • -1: No se encontró resultado
      • -2: Formato de número de teléfono incorrecto
      • -3: Servicio del centro de verificación ocupado
  • description, descripción del resultado del negocio.
  • status_code, código de estado:
    • 0: Normal
    • 1: Apagado
    • 2: Número cancelado
    • 3: Número vacío
    • 4: No en la red
    • 99: Estado desconocido
Se puede ver que el estado de este número de teléfono ya ha sido consultado. 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 consulta de estado de número de teléfono para verificar el estado de un número de teléfono móvil, puedes ingresar el número de teléfono para realizar la consulta. 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.