API & Integrazioni
Documentazione tecnica in preview. Gli endpoint definitivi saranno pubblicati con la versione 1.0 dell'API.
REST semplice
Endpoint /v1/jobs, /v1/jobs/{id}, /v1/lookups. Tutte le risposte in JSON.
Webhook di completamento
Ricevi un POST firmato appena il job termina, con URL firmato per il download.
Chiavi API con scope
Chiavi separate per lookup, upload, admin. Rotazione e revoca in un click.
Crea un job
POST /v1/jobs
curl -X POST https://api.numerovero.online/v1/jobs \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"name": "Lista Q4",
"default_country": "IT",
"numbers": ["+39335...", "3480000000"],
"webhook_url": "https://tuo-dominio.it/webhooks/numerovero-online"
}'Payload webhook
POST verso il tuo endpoint
{
"event": "job.completed",
"job_id": "job_01H...",
"totals": { "input": 1000, "valid": 980, "invalid": 15, "duplicates": 5 },
"distribution": { "reachable": 720, "active": 160, "unreachable": 45, "inactive": 55, "unknown": 0 },
"credits": { "reserved": 980, "consumed": 980, "released": 0 },
"download_url": "https://storage.numerovero.online/exports/...(URL firmato)"
}