> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.
# Verificación de los tres elementos del número de teléfono API Instrucciones de integración
> Identity Authentication API guide - Ace Data Cloud
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](https://platform.acedata.cloud/console/applications) 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](https://platform.acedata.cloud/console/coin).
> 📘 Documentación completa: [API de verificación de los tres elementos del número de teléfono →](https://platform.acedata.cloud/documents/identity-phone-check-3e)
## 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:
```json theme={null}
{
"result": "0",
"description": "Autenticación aprobada",
"isp": "Móvil",
"result_detail": null
}
```
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:
```shell theme={null}
curl -X POST 'https://api.acedata.cloud/identity/phone/check-3e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"name": "***",
"phone": "***",
"id_card": "***"
}'
```
El código de integración en Python es el siguiente:
```python theme={null}
import requests
url = "https://api.acedata.cloud/identity/phone/check-3e"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"name": "***",
"phone": "***",
"id_card": "***"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
```
## 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
```json theme={null}
{
"success": false,
"error": {
"code": "api_error",
"message": "la recuperación falló"
},
"trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
```
## 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.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.