Un solo flujo, en el panel y en la API
Pruebe las verificaciones en el panel y luego conecte su servidor a las mismas verificaciones individuales y masivas mediante la API.
Empiece con una verificación individual
Envíe las solicitudes a https://api.numdetect.com con una clave de API guardada en su servidor. Puede crear varias claves en el panel, una por sistema, y eliminar cualquiera de ellas. No ponga una clave en el código del frontend.
curl "https://api.numdetect.com/api/v1/checks" \
-H "Authorization: Bearer $NUMDETECT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"phone": "+12025550147",
"products": [
"whatsapp"
]
}'Solicitud ilustrativa con un número de muestra. Sustituya $NUMDETECT_API_KEY por su clave; cada ejecución es una verificación real y se cobra.
Qué devuelve una verificación
Cada dato recibe una entrada por producto. Lea primero registered: true y false son concluyentes, null es desconocido. Una verificación individual solo cobra true y false; un grupo por volumen se cobra completo cuando termina su lote.
{
"id": "10000000-0000-4000-8000-000000000001",
"input_kind": "phone",
"input": "+12025550147",
"country": "US",
"charged": 4000,
"results": [
{
"product_id": "whatsapp",
"status": "success",
"result": true,
"price": 4000,
"charged": 4000
}
]
}status- success: una respuesta definitiva; unknown: sin respuesta concluyente; failed: no se pudo contactar con el producto. Solo se cobra success.
result- true: se encontró una cuenta; false: no hay cuenta; null cuando status no es success.
info- Campos adicionales que devuelven algunos productos, como la señal de WhatsApp Business.
price- El precio de este producto para la verificación, en USD micros (1.000.000 = 1 $).
charged- Lo que se cobró realmente: el precio si la respuesta es definitiva; en caso contrario, 0.
01
Explore en el panel
Ejecute algunas verificaciones individuales en el panel para ver las entradas y las respuestas antes de escribir su integración.
02
Consulte el catálogo actual
Consulte la lista de productos para ver cuáles están a la venta, sus tipos de entrada, países y precios. No los fije en el código a partir del sitio web público.
03
Cree una tarea y haga su seguimiento
Envíe un Idempotency-Key al crear una verificación o una tarea masiva. Si se pierde una respuesta, reintente con la misma clave en lugar de usar una nueva.
Flujo de trabajo masivo de teléfonos
- 1
Suba el archivo CSV o de texto con los productos, la columna de números y el máximo que acepta pagar.
- 2
La lista se divide por país; cada país se verifica con cada producto que haya elegido.
- 3
Siga la tarea hasta que termine, o reciba un webhook.
- 4
Descargue un único archivo de resultados con todas las filas originales y una columna de respuesta por producto.
Mantenga las claves en su servidor
- Hasta 10 claves de API Bearer por cuenta, cada una eliminable en cualquier momento.
- Se envía un webhook firmado cuando termina una tarea masiva.
- Los archivos de resultados se descargan mediante un enlace válido durante 10 minutos.
Use variables de entorno para las credenciales y elimine una clave en el panel si queda expuesta. Incluya los ID de verificación o de tarea al pedir soporte; nunca pegue claves de API en capturas de pantalla ni en ejemplos públicos.
¿Listo para verificar sus números?
Empiece justo después de registrarse, sin aprobación previa. Recargue su saldo y verifique números reales.