Di che operatore è quel numero?
Sapere a quale operatore appartiene un numero è utile, ma il prefisso non lo rivela più: con la portabilità un numero cambia gestore restando lo stesso.
Esegui online
Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.
L'operatore reale si ottiene solo interrogando l'HLR, un archivio su licenza proprio di ogni rete. Questo endpoint non fa quella consultazione: non restituisce l'operatore, il tipo di linea né il paese. Quello che funziona oggi è controllare il formato del numero.
Perché il prefisso non dà più l'operatore
Un tempo le prime cifre di un cellulare indicavano il gestore. La portabilità ha cambiato tutto: si cambia operatore tenendo lo stesso numero, quindi il prefisso non dice più nulla di affidabile. L'unica fonte autorevole dell'operatore attuale è l'HLR della rete — un archivio su licenza, per operatore. Ecco perché conoscere il gestore reale è un servizio su licenza, non un dato che si deduce dal numero. Indovinare da un prefisso vecchio dà risposte sicure e sbagliate, ed è proprio ciò che questo endpoint si rifiuta di fare.
Cosa restituisce questo endpoint oggi
Questo endpoint non interroga l'HLR. Non restituisce l'operatore, il tipo di linea né il paese. Collegare la rilevazione del gestore in tempo reale richiede un fornitore HLR su licenza, qui non collegato. Preferiamo dirlo apertamente piuttosto che restituire un operatore indovinato, su cui la tua logica di instradamento o di costo si fiderebbe senza saperlo.
Cosa puoi fare oggi: controllare il formato
Quello che funziona è controllare il formato del numero: verificare che abbia struttura e lunghezza plausibili per il prefisso internazionale, scovando una cifra in più o in meno prima di usarlo. Il controllo del formato del KIT lo fa — gratis nel browser — ed è il passo giusto prima di mandare un numero a un servizio di operatore su licenza. Non ti dice il gestore, ma ferma il numero rotto alla porta.
Se ti serve il dato dell'operatore
Se il tuo caso richiede davvero l'instradamento per operatore o tipo di linea, serve un feed HLR su licenza: è una scelta di funzionalità, non un'approssimazione che questo endpoint tenterebbe. Nel frattempo valida il formato per mandare solo numeri ben formati al servizio che scegli, e tratta la rilevazione del gestore come un passo a parte, da un fornitore su licenza.
Casi d'uso
Scartare un numero sbagliato in registrazione
Validare il formato del numero in registrazione rifiuta una cifra in più o in meno prima di salvarlo, con il controllo del formato e non una ricerca dell'operatore.
Preparare i numeri per una ricerca operatore su licenza
Validare prima il formato assicura che solo numeri ben formati vadano a un servizio HLR su licenza, senza sprecare richieste su una cifra sbagliata.
Non scegliere il canale su un operatore indovinato
Poiché il tipo di linea non viene restituito qui, non decidere tra SMS e chiamata da un operatore indovinato; valida il formato e conferma la consegna dal riscontro del tuo provider SMS.
Domande frequenti
Questo endpoint restituisce l'operatore?
No. Non restituisce l'operatore, il tipo di linea né il paese. Con la portabilità l'operatore attuale viene solo da un archivio su licenza (HLR); un prefisso non basta, e questo endpoint non fa quella consultazione.
Cosa posso usare oggi?
Il controllo del formato del numero — gratis nel browser. La rilevazione dell'operatore richiede un fornitore su licenza e non è fornita da questo endpoint.
Quanto costa?
$0.002 a richiesta, senza abbonamento. L'accesso al KIT funziona a consumo, e una richiesta fallita non viene addebitata.
Il numero che cerco viene conservato?
No. Serve solo al momento del trattamento, poi viene eliminato. Non teniamo archivi dei numeri che verifichi.
Mi dice il nome o l'intestatario del numero?
No: non restituisce né l'intestatario né l'operatore. Risalire all'intestatario non è una funzione che offriamo, e l'operatore richiederebbe un archivio su licenza qui non collegato.
Serve solo a controllare il formato?
Il controllo del formato, gratis nel browser, è proprio ciò che funziona oggi. Questo endpoint non aggiunge l'operatore: quello richiederebbe una consultazione HLR su licenza.
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/verify/phone-carrier \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"+34600123456"}'const res = await fetch("https://api.kit.forhosting.com/verify/phone-carrier", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"phone": "+34600123456"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/verify/phone-carrier",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"phone": "+34600123456"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/verify/phone-carrier", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"phone":"+34600123456"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"phone":"+34600123456"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/phone-carrier", 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": "+34600123456"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "verify.phone_carrier",
"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.
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. |