Verificación síncrona
Cómo comprobar en tiempo real el registro de un número de teléfono en Telegram
Envíe un número de teléfono E.164 y lea su estado de registro en Telegram en la misma respuesta síncrona de la API.
El producto responde a una pregunta precisa
TG Validator comprueba si el número de teléfono enviado está registrado en Telegram en el momento de la solicitud.
El producto acepta un número de teléfono E.164, utiliza service_type=tg y devuelve el resultado completado en la misma respuesta HTTP. No hay ningún ID de trabajo que consultar ni se necesita ningún callback antes de que la aplicación pueda leer data.registered.
El alcance termina en el estado de registro. La respuesta no proporciona el nombre de usuario de Telegram, el perfil, el estado de actividad, los contactos, los grupos ni datos de mensajes. Tampoco identifica a la persona que controla el número de teléfono. No son funciones ocultas: están fuera del contrato del producto.
Un false completado no es lo mismo que una verificación fallida
| Datos devueltos | Decisión de registro | Cómo utilizarlo |
|---|---|---|
code=0, registered=true |
Registrado en el momento de la verificación | Utilice true como resultado de esta solicitud |
code=0, registered=false |
No registrado en el momento de la verificación | Utilice false como resultado de esta solicitud |
| Código de negocio distinto de cero | Sin decisión de registro | No cree un booleano; gestione el error o reintente según la documentación de la API |
La distinción es importante porque registered=false es información útil producida por una verificación completada. Un error de la API se devuelve a través del sobre exterior con su propio estado HTTP y su code numérico; no es otro valor de data.registered.
El recorrido de la solicitud síncrona
- Prepare la entrada E.164: parta del contexto de país conocido y normalice el número a un signo más, el prefijo telefónico del país y los dígitos.
- Autentique la solicitud: utilice una clave API creada en Configuración y envíela con el encabezado documentado.
- Elija el producto de Telegram: establezca
service_type=tg; no deduzca el producto a partir de campos no relacionados. - Espere la misma respuesta: la verificación es síncrona, por lo que la aplicación recibe la decisión sin consultas periódicas.
- Lea los campos exactos del resultado: utilice
data.registeredcuandocode=0; déjelo sin asignar cuando la API devuelva un código de negocio distinto de cero. - Registre el momento de la verificación: trate el resultado como una observación actual, no como una garantía indefinida.
Dónde ayuda el comportamiento en tiempo real
El contrato síncrono encaja bien con el software que necesita una decisión de registro actual antes de continuar. Un operador puede verificar un registro en el panel, una aplicación interna puede validar un número enviado o un proceso de backend puede tratar los registros de uno en uno.
Para una lista pequeña, el endpoint síncrono por lotes acepta hasta 100 identificadores E.164 y devuelve el lote completado en la respuesta de la solicitud inicial. El cliente se encarga de la planificación y de la concurrencia. Así se mantiene un contrato de API sencillo: cada resultado completado tiene una entrada, un resultado de registro en Telegram y un momento de observación.
Un registro mínimo en la aplicación
Utilice campos explícitos en lugar de una etiqueta ambigua como valid:
| Campo | Finalidad |
|---|---|
source_phone |
Conserva lo que proporcionó el sistema de origen |
e164_phone |
Almacena el número canónico que se verificó |
service_type |
Registra tg como contrato del resultado |
outcome |
La clasificación de su aplicación: completada, reintentable o solicitud fallida |
registered |
Almacena true/false solo para verificaciones completadas |
checked_at |
Marca con fecha y hora la observación de registro |
Si una aplicación necesita una respuesta más reciente, debe realizar otra llamada síncrona. No debe cambiar la marca de tiempo de un valor antiguo ni afirmar que un valor almacenado en caché es en tiempo real.
La regla de integración que evita datos falsos
code=0 confirma que el booleano registered es la respuesta de registro completada.
Esta interpretación en dos fases mantiene los problemas de entrada y las condiciones temporales del servicio fuera del campo de estado de Telegram. También hace precisa la promesa del producto: TG Validator proporciona de forma síncrona una observación de registro actual cuando la verificación se completa, mientras que el sistema integrador decide cuándo necesita una nueva observación.