Guida rapida all’API

Ottieni la tua chiave API

L’API richiede un account Pro attivo. Nel tuo account crea una chiave API e copiala: viene mostrata una sola volta. Salvala come secret NOCALL_API_KEY sul tuo server, mai nel codice del browser.

1. 1

   Crea una API key nel tuo account e copia il valore mostrato una sola volta. Configura NOCALL_API_KEY come segreto sul server. Usa HTTPS; non inserire mai la chiave nel codice del browser, repository, screenshot o log.

2. 2

   Invia la chiave completa in Authorization: Bearer, con uno spazio dopo Bearer. Non usare X-API-Key e non inserire la chiave nell’URL.

• Crea chiave API ↗

La tua prima richiesta

Invia POST /v2/tools con l’header Authorization: Bearer e un corpo JSON con tool e phone, ad esempio per who-calls. Usa una nuova Idempotency-Key per ogni operazione, così puoi ripeterla senza un secondo addebito.

Tutti i 44 tool sono disponibili tramite API: chiama POST /v2/<tool-id>, oppure POST /v2/tools con il campo tool nel corpo. Ogni tool ha il proprio corpo JSON, documentato nella sua guida. data.result contiene il risultato del tool. Usa gli identificatori riportati nella tabella.

REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/tools' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"tool":"who-calls","phone":"+12025550123","country":"US"}'

import json
import os
import urllib.request
import uuid

api_key = os.environ.get('NOCALL_API_KEY')
if not api_key:
    raise SystemExit('Set NOCALL_API_KEY')

request = urllib.request.Request(
    'https://api.nocall.io/v2/tools',
    method='POST',
    data=json.dumps({'tool': 'who-calls', 'phone': '+12025550123', 'country': 'US'}).encode(),
    headers={
        'Authorization': 'Bearer ' + api_key,
        'Content-Type': 'application/json',
        'Idempotency-Key': str(uuid.uuid4()),
    },
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)
print(result['data']['result'], result['meta']['unitsCharged'])

import { randomUUID } from 'node:crypto';

const requestId = randomUUID();
const apiKey = process.env.NOCALL_API_KEY;
if (!apiKey) throw new Error('Set NOCALL_API_KEY');

const response = await fetch('https://api.nocall.io/v2/tools', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + apiKey,
    'Content-Type': 'application/json',
    'Idempotency-Key': requestId,
  },
  body: JSON.stringify({ tool: 'who-calls', phone: '+12025550123', country: 'US' }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code ?? 'request_failed');
console.log(result.data.result, result.meta.unitsCharged);

La risposta

data.result contiene il risultato e meta include requestId, unitsCharged e l’utilizzo del periodo. Il riferimento API descrive i campi di tutte le tools.

data contiene il risultato; meta include requestId, unitsCharged e l’utilizzo se pertinente. L’estratto fittizio mostra il saldo dopo una richiesta. Anche un risultato valido senza dati costa 1 credito; errori di convalida o del fornitore e lettura del saldo sono gratuiti. L’assenza di dati non prova che il numero sia sicuro. Consulta OpenAPI per gli schemi completi.

Crediti ed errori

Ogni risultato valido consuma 1 credito, anche senza dati; gli errori di validazione sono gratuiti. 401 indica che la chiave manca o non è valida, 403 che non c’è un Pro attivo e 429 che i crediti sono esauriti o è stato raggiunto il limite di richieste.

Guide correlate

• Riferimento APIOgni chiamata all'API costa 1 credito. Si usano prima quelli mensili.
• Chi mi chiama?Scopri chi ha chiamato da un numero sconosciuto. Controlla le segnalazioni della community, verifica i prefissi e proteggiti dalle truffe telefoniche.
• Rischio telefonicoInserisci un numero per consultare dati approvati e limitati dalla privacy.

Guide correlate

• Riferimento API
• Chi mi chiama?
• Rischio telefonico