Intelligence sui numeri di telefono. Tipo di linea, operatore, portabilità, segnali di frode.
Carrier lookup con supporto MNP sulla stessa infrastruttura che trasporta il traffico SMS e Voice di Bird. Un unico endpoint, stessa autenticazione, stesso formato di errore di ogni altro canale Bird, perché lo stesso team di ingegneri li ha costruiti tutti.
5 minutes from npm install to first lookup
Effettua il lookup di un numero nel linguaggio che già utilizzi.
SDK per ogni runtime principale. Risposte di lookup in meno di 300 ms al valore mediano, abbastanza veloce da condizionare l'invio di un SMS.
Code samples arrive when this API ships. The SDKs already cover the live channels.
Dieci campi che altrimenti dovresti assemblare da tre fornitori diversi.
Dati concreti, nominati e verificabili. Ognuno proviene da una fonte reale, non da un modello che indovina.
- 01
Rilevamento del tipo di linea
Mobile, fisso, VoIP, numero verde, premium, cercapersone. Decidi se l'SMS è possibile prima ancora di inviarlo.
- 02
Identificazione dell'operatore
Nome dell'operatore attuale e codice paese per input E.164. Aggiornato continuamente rispetto ai registri MNP.
- 03
Storico della portabilità
L'operatore precedente da cui il numero è stato portato. Utile per la previsione dei costi di instradamento e le euristiche antifrode.
- 04
Formato paese e regione
Restituisce il formato E.164, nazionale e internazionale; i codici paese e regione necessari al router.
- 05
Segnali di frode
Un fraud_score da 0 a 1 per numero, che combina velocità, euristiche sul tipo di linea, flag di portabilità recente e liste di numeri noti come malevoli.
- 06
Validità e raggiungibilità
Un booleano valid e una finestra di raggiungibilità: alcuni numeri superano il parsing ma l'operatore non li assegna più.
- 07
Lookup in batch
Invia tramite POST una lista di fino a 1.000 numeri in una singola chiamata. Si applica lo stesso prezzo per numero; risparmi i round trip.
- 08
Prezzi con gestione della cache
La cache di 24 ore su input identici è gratuita. Paghi solo quando la risposta sarebbe effettivamente diversa.
- 09
Webhook per job in batch
Per batch di grandi dimensioni, iscriviti a lookup.completed e leggi il file dei risultati invece di mantenere aperta una connessione HTTP.
- 10
Stessa autenticazione, stesso formato di errore
Una sola API key per Lookup, SMS, Email, WhatsApp, Voice. Un unico registro dei tipi di errore per tutti.
Perché abbiamo creato Lookup
Perché non dovresti scoprire che un numero è un fisso guardando l'SMS fallire.
Stavamo già eseguendo lookup MNP all'interno del routing SMS di Bird: dovevamo farlo per scegliere la rotta operatore più economica in tempo reale. Lookup è quella stessa query, esposta come endpoint di prima classe, così puoi filtrare le registrazioni, valutare il rischio e prevedere i costi di routing senza inviare un singolo SMS. Stessa autenticazione, stesso formato di errore, stessi webhook del resto della piattaforma.
Ogni cambio di stato è un webhook.
Payload firmati con HMAC, protetti dal replay, idempotenti. I lookup su singolo numero sono sincroni; i lookup in batch vengono distribuiti come webhook.
Pianificazione dei tentativi: 5s, 30s, 5m, 30m, 2h, 6h, 12h. Dead-letter dopo l'ultimo tentativo; ogni evento in dead-letter è riproducibile dalla dashboard o dall'API.
lookup.completedUn lookup (singolo o batch) è terminato. Il payload include la risposta completa.lookup.failedIl lookup non è stato possibile; il payload include il formato di errore.
Cerca il numero, poi invia.
Stessa autenticazione, stesso contratto di idempotenza, stesso formato di errore. Lookup ha la stessa struttura di ogni altro endpoint. La differenza è che restituisce dati invece di inviare un messaggio.
Lookup.
Operatore, tipo di linea, portabilità, segnali di frode: restituiti in modo sincrono in meno di 300 ms.
SMS.
Stessa autenticazione, stesso formato di errore. Condiziona l'invio sul risultato del lookup: scarta i numeri fissi prima che ti costino.