ForHosting KIT · Dati e file

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.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

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.

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.

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.

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.

POSThttps://api.kit.forhosting.com/data/phone-number-format

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

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"}'
{
  "phone_number": "(202) 555-0147",
  "country_code": "US"
}
{
  "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.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_mb25
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →