Formatti un numero di telefono internazionale per Paese
I numeri di telefono sono facili da memorizzare come testo libero, ma presentarli in modo uniforme è più complesso.
Esegui gratis nel browser
Questo strumento riceve un numero e un codice Paese di due lettere, elimina la punteggiatura comune, verifica il prefisso internazionale quando è presente e controlla il numero esatto di cifre nazionali. Restituisce quindi una forma internazionale leggibile e una forma E.164 compatta. Lunghezze errate e prefissi incompatibili producono un errore esplicito anziché un risultato plausibile ma inaffidabile.
Indichi il numero e il Paese di appartenenza
Inserisca il numero di telefono nel formato disponibile e selezioni il relativo codice Paese di due lettere. L’input nazionale può contenere separatori comuni come spazi, parentesi, punti o trattini. Può anche fornire un numero internazionale che inizi con il segno più oppure usare il prefisso internazionale 00. Quando è presente un prefisso internazionale, lo strumento verifica che il codice di chiamata corrisponda al Paese selezionato. Questo controllo è importante perché la stessa sequenza di cifre nazionali può sembrare strutturalmente valida in più luoghi. Il Paese è quindi un’istruzione esplicita, non un’ipotesi ricavata dalle cifre. Nei Paesi che usano uno zero di preselezione nazionale, l’input può conservarlo; lo zero viene rimosso quando la notazione internazionale lo richiede. Il risultato comprende il codice ISO normalizzato, il prefisso telefonico, il numero nazionale significativo, il valore E.164 compatto e una versione con spazi per la visualizzazione. La risposta è così adatta sia alle interfacce sia all’archiviazione normalizzata e ai confronti successivi.
Comprenda che cosa garantisce la convalida
Lo strumento esegue una convalida strutturale per i Paesi presenti nel selettore. Verifica i caratteri consentiti, la corrispondenza tra un prefisso esplicito e il Paese scelto, nonché il numero previsto di cifre nazionali. In caso di discrepanza restituisce un errore che specifica il Paese, il conteggio atteso e quello ricevuto. La rigidità è intenzionale: aggiungere, troncare o inventare cifre senza avviso potrebbe creare un numero che non appartiene a nessuno. La validità strutturale non dimostra che una linea sia assegnata, attiva, raggiungibile o mobile, né che appartenga a una determinata persona. Lo strumento non contatta un operatore e non invia messaggi di verifica. Opera esclusivamente sul testo fornito mediante una tabella fissa di regole nazionali. Poiché non effettua richieste di rete, lo stesso input produce sempre la stessa risposta e il numero non viene condiviso con servizi di elenchi. Consideri l’output una rappresentazione affidabile di una struttura conforme, non una prova dell’esistenza dell’abbonato o del suo consenso a essere contattato.
Usi correttamente le due forme normalizzate
Il campo formattato è pensato per la visualizzazione: inizia con il prefisso preceduto dal segno più e separa le cifre nazionali in gruppi consueti per il Paese. Il campo E.164 elimina gli spazi ed è più adatto a database, confronti di uguaglianza, payload API e collegamenti che richiedono un valore internazionale compatto. Salvi il codice Paese insieme al numero normalizzato quando l’applicazione deve conservare il contesto dichiarato dall’utente. Se raccoglie telefoni mediante un modulo, li convalidi prima del salvataggio, così un errore nel numero di cifre potrà essere corretto mentre la fonte è ancora disponibile. Nelle importazioni conservi la cella originale in una colonna di controllo e scriva il risultato normalizzato in un campo separato; in questo modo la pulizia non cancella le informazioni sull’input. Tratti sempre i telefoni come testo, mai come valori numerici, per mantenere gli zeri iniziali. Infine, ricordi che la formattazione non equivale a un’autorizzazione: applichi le consuete regole di consenso, riservatezza e messaggistica prima di chiamare o scrivere a qualsiasi numero restituito.
Casi d'uso
Normalizzare i numeri inseriti dai clienti
Rifiuti subito conteggi di cifre errati e salvi una rappresentazione internazionale uniforme.
Ripulire un’importazione di contatti
Converta punteggiatura e notazioni nazionali diverse in campi stabili di visualizzazione ed E.164.
Preparare numeri per un’altra API
Produca un valore internazionale compatto mantenendo una versione raggruppata e leggibile per il controllo.
Domande frequenti
Quanto costa una richiesta API?
Ogni richiesta costa $0.002. La versione per browser può essere eseguita localmente in questa pagina.
Un risultato valido indica che il numero è attivo?
No. Conferma la struttura e il conteggio delle cifre per il Paese supportato, non assegnazione, raggiungibilità, titolarità o consenso.
Posso includere spazi o punteggiatura?
Sì. Spazi, parentesi, punti e trattini vengono ignorati. Il segno più è consentito solo all’inizio.
Posso fornire un numero internazionale?
Sì. Usi un segno più iniziale o il prefisso 00. Il codice di chiamata deve corrispondere al Paese selezionato.
Perché lo zero nazionale iniziale è stato rimosso?
Alcuni Paesi usano uno zero di preselezione solo per le chiamate nazionali. La notazione internazionale lo omette e il valore normalizzato segue tale convenzione.
Perché il mio Paese non è presente?
La capacità espone solo Paesi con una regola esplicita e verificata. Per i piani non supportati restituisce un errore invece di formulare ipotesi.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/data/phone-number-format \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"phone_number":"(202) 555-0147","country_code":"US"}'const res = await fetch("https://api.kit.forhosting.com/data/phone-number-format", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"phone_number": "(202) 555-0147",
"country_code": "US"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/data/phone-number-format",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"phone_number": "(202) 555-0147",
"country_code": "US"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/phone-number-format", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"phone_number":"(202) 555-0147","country_code":"US"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"phone_number":"(202) 555-0147","country_code":"US"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/phone-number-format", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"phone_number": "(202) 555-0147",
"country_code": "US"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "data.phone_number_format",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_mb | 25 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |