Documentación API

Integra la detección de números en minutos

URL Base

https://api.zelnum.com/api/v1

El dominio de la API está separado a propósito del de la Consola, para poder escalar y proteger la API de forma independiente. Por eso los ejemplos usan api.zelnum.com y tu panel está en app.zelnum.com.

Autenticación

Todos los endpoints requieren una clave API en el header.

Formato de Respuesta

Todos los endpoints devuelven JSON.

Flujo Típico

1. Consultar Saldo — GET /v1/balance
2. Detección (Array) — POST /v1/detect · POST /v1/detect/file
3. Estado de Tarea — GET /v1/tasks/{token}
4. URL de Descarga — GET /v1/tasks/{token}/result · GET /v1/tasks/{token}/download

Comprobación individual en tiempo real

Nota

La detección por lotes pre-cobra el envío completo y, al finalizar la tarea, reembolsa automáticamente los números que quedaron sin comprobar (prefiltrados, duplicados o no procesados). Solo pagas por los números realmente procesados.

Nota

Cada producto usa el precio por consulta fijado para la solicitud, incluso con caché. Solo valid e invalid se cobran; unknown, los tiempos de espera y los elementos ocupados se reembolsan.

SDK oficial

El cliente de Python envuelve los endpoints de esta página: respuestas tipadas, claves de idempotencia y descarga de resultados por lotes. Hoy es el único SDK mantenido oficialmente; para cualquier otro lenguaje, llama directamente a la API REST.

• Python — https://github.com/Zelnum/zelnum-python · https://pypi.org/project/zelnum/

Referencia

• Autenticación
• Consultar Saldo
• Límites de solicitudes
• Códigos de Error
• Productos
• Ejemplos