Chiamate e numeri
Formati dei numeri
Copertura: Le zone provengono dal piano di numerazione ufficiale del paese di ogni edizione. La Spagna indica una provincia per ogni numerazione fissa; molti altri paesi pubblicano i propri prefissi e città. I cellulari non hanno una zona in nessun paese, e alcuni paesi non pubblicano ancora un piano che possiamo leggere: lì mostriamo solo il tipo di linea.
Apri lo strumentoIn questa pagina
A cosa serve
Controlla se un numero di telefono è valido, se è un cellulare, un fisso, un numero verde o a sovrapprezzo, e visualizzalo in formato E.164, nazionale e internazionale.
Requisiti
Chiunque può leggere queste guide, senza account. Alcuni strumenti richiedono Pro, come indicato in ogni guida.
Inserisci il numero completo con prefisso internazionale. Per un numero nazionale, verifica prima il paese dell’edizione o del selettore.
Come usarlo
Formati dei numeri
Inserisci il numero completo con prefisso internazionale. Per un numero nazionale, verifica prima il paese dell’edizione o del selettore.
Controlla
E.164 · Senza prefisso internazionale · Formato internazionale
Esempio inventato
Esempio inventato, non una ricerca reale. Non chiamare e non aprire i suoi link.
+44 1632 960123Interpretare il risultato
È lo standard internazionale per scrivere un numero: un segno più, il prefisso del paese e il numero nazionale, senza spazi né zero iniziale. App e sistemi telefonici lo usano per memorizzare i numeri.
Limiti
Solo formati e prefissi supportati. Non confermano posizione, intestatario o attività del numero. Alcuni prefissi sono condivisi.
Risoluzione dei problemi
Se il dato non è valido, controlla formato e paese. Riprova dopo errori di connessione; rispetta l’attesa quando raggiungi un limite.
Numero di telefono non valido
Il controllo di sicurezza o la connessione all'API non ha risposto in tempo. Riprova tra qualche secondo.
Usare con l’API
Richiede una API key e dei crediti. Ogni chiamata completata costa 1 credito, anche quando non ci sono dati. Un account Pro attivo include 20 crediti per mese solare UTC, condivisi da tutte le rotte API e consumati per primi; i crediti mensili non usati non passano al mese successivo. I crediti acquistati nella pagina del tuo account funzionano senza Pro e non scadono mai.
Gli errori non vengono mai addebitati: 401 invalid_api_key (chiave mancante o non valida), 403 pro_required (nessun credito Pro e nessun credito acquistato), 422 input non valido, 429 quota_exceeded (crediti esauriti), rate_limit_exceeded o ai_busy (l’IA di sms-check è al limite della capacità), 503 tool_warming (i dati sono ancora in preparazione) o tool o provider non disponibile. Dopo un 429 o un 503, riprova quando sono trascorsi i secondi indicati nell’intestazione Retry-After.
Formati E.164, nazionale e internazionale, prefisso internazionale, paese e validità secondo il piano di numerazione. Un numero possibile ma non assegnato restituisce valid=false.
Invia il corpo JSON alla rotta specifica del tool, oppure a POST /v2/tools aggiungendo il campo tool. Entrambe le rotte restituiscono lo stesso risultato.
POST https://api.nocall.io/v2/phone-formats
POST https://api.nocall.io/v2/tools {"tool":"phone-formats","phone":"+34912345678","country":"ES"}Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| phone | string (1–40) | Sì | Numero di telefono in formato E.164 (+34…) o nazionale. |
| country | string (enum, 56) | No (predefinito: "ES") | Codice paese di due lettere, ad esempio ES o US, usato per l’input nazionale e per i dati del paese. |
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/phone-formats' \
--header "Authorization: Bearer $NOCALL_API_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $REQUEST_ID" \
--data '{"phone":"+34912345678","country":"ES"}'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/phone-formats',
method='POST',
data=json.dumps({'phone': '+34912345678', 'country': 'ES'}).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/phone-formats', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': requestId,
},
body: JSON.stringify({ phone: '+34912345678', country: 'ES' }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code ?? 'request_failed');
console.log(result.data.result, result.meta.unitsCharged);Esempio di risposta (200)
Questo è l’esempio documentato nel riferimento API. Le ricerche usano un numero fittizio, mentre aggregati e risposte dell’IA mostrano la struttura del risultato, non dati reali.
{
"data": {
"tool": "phone-formats",
"result": {
"e164": "+34912345678",
"national": "912 34 56 78",
"international": "+34 912 34 56 78",
"callingCode": "34",
"country": "ES",
"valid": true
}
},
"meta": {
"requestId": "req_example",
"unitsCharged": 1,
"usage": {
"periodStart": "2026-10-01",
"unitLimit": 20,
"unitsUsed": 3,
"unitsRemaining": 17
}
}
}Campi del risultato (data.result)
| Campo | Tipo | Descrizione |
|---|---|---|
| e164 | string | Il numero in formato E.164, oppure null se non può essere formattato. |
| national | string | Il numero nel formato nazionale del suo paese. |
| international | string | Il numero in formato internazionale. |
| callingCode | string | Prefisso internazionale del paese del numero, oppure null se sconosciuto. |
| country | string | null | Paese del numero (codice ISO), oppure null se non può essere determinato. |
| valid | boolean | Se il numero è valido secondo il piano di numerazione. false è comunque un risultato completato. |
