Informacje o numerach telefonów. Typ linii, operator, historia przeniesień, sygnały oszustw.
Wyszukiwanie operatora z uwzględnieniem MNP — przez te same łącza, którymi przechodzi ruch SMS i Voice Bird. Jeden endpoint, to samo uwierzytelnianie, ten sam format błędów co w każdym innym kanale Bird, bo wszystko zbudował ten sam zespół inżynierów.
5 minutes from npm install to first lookup
Sprawdź numer w języku, którego już używasz.
SDK dla każdego popularnego środowiska uruchomieniowego. Odpowiedzi z Lookup w medianie poniżej 300 ms — wystarczająco szybko, by warunkować wysyłkę SMS.
Code samples arrive when this API ships. The SDKs already cover the live channels.
Dziesięć pól, które normalnie składałbyś od trzech dostawców.
Konkretne punkty danych, nazwane i audytowalne. Każdy pochodzi z realnego źródła, a nie z modelu zgadującego.
- 01
Wykrywanie typu linii
Komórkowy, stacjonarny, VoIP, bezpłatny, premium, pager. Zdecyduj, czy SMS jest w ogóle możliwy, zanim go wyślesz.
- 02
Identyfikacja operatora
Aktualna nazwa operatora i kod kraju na podstawie numeru E.164. Ciągle aktualizowane na podstawie rejestrów MNP.
- 03
Historia przeniesień numeru
Poprzedni operator, od którego numer został przeniesiony. Przydatne do prognozowania kosztów routingu i heurystyk wykrywania oszustw.
- 04
Format kraju i regionu
Zwraca formatowanie E.164, krajowe i międzynarodowe; kody kraju i regionu potrzebne routerowi.
- 05
Sygnały oszustw
fraud_score 0–1 dla każdego numeru, łączący prędkość, heurystyki typu linii, flagi niedawnych przeniesień i listy znanych zagrożeń.
- 06
Ważność i osiągalność
Boolean valid i okno reachable: niektóre numery parsują się poprawnie, ale operator już ich nie przydziela.
- 07
Wyszukiwanie wsadowe
Wyślij POST z listą do 1000 numerów w jednym wywołaniu. Obowiązuje ta sama cena za numer; oszczędzasz na liczbie zapytań.
- 08
Cennik z uwzględnieniem cache
24-godzinny cache dla identycznych zapytań jest bezpłatny. Płacisz tylko wtedy, gdy odpowiedź faktycznie byłaby inna.
- 09
Webhooki dla zadań wsadowych
Dla dużych partii subskrybuj lookup.completed i odczytaj plik wynikowy zamiast utrzymywać połączenie HTTP.
- 10
Ta sama autoryzacja, ten sam format błędów
Jeden klucz API dla Lookup, SMS, Email, WhatsApp, Voice. Jeden rejestr typów błędów dla wszystkich.
Dlaczego stworzyliśmy Lookup
Bo nie powinieneś dowiadywać się, że numer jest stacjonarny, obserwując niepowodzenie SMS.
Wyszukiwania MNP już działały wewnątrz routingu SMS Bird — musieliśmy je mieć, by w czasie rzeczywistym wybierać najtańszą trasę operatora. Lookup to dokładnie to samo zapytanie, udostępnione jako pełnoprawny endpoint — dzięki niemu możesz weryfikować rejestracje, oceniać ryzyko i prognozować koszty routingu bez wysyłania ani jednego SMS. To samo uwierzytelnianie, ten sam format błędów, te same webhooki co w całej platformie.
Każda zmiana stanu to webhook.
Ładunki podpisane HMAC, zabezpieczone przed powtórzeniem, idempotentne. Wyszukiwania pojedynczych numerów są synchroniczne; wyszukiwania wsadowe rozsyłane są jako webhooki.
Harmonogram ponawiania: 5 s, 30 s, 5 min, 30 min, 2 godz., 6 godz., 12 godz. Dead-letter po ostatniej próbie; każde zdarzenie dead-letter można ponowić z panelu lub API.
lookup.completedWyszukiwanie (pojedyncze lub wsadowe) zakończone. Ładunek zawiera pełną odpowiedź.lookup.failedNie udało się wykonać wyszukiwania; ładunek zawiera format błędu.
Sprawdź numer, a potem wyślij do niego wiadomość.
To samo uwierzytelnianie, ten sam kontrakt idempotentności, ten sam format błędów. Lookup wygląda jak każdy inny endpoint. Różnica polega na tym, że zwraca dane zamiast wysyłać wiadomość.
Lookup.
Operator, typ linii, informacja o przeniesieniu numeru, sygnały fraudowe — zwracane synchronicznie w czasie poniżej 300 ms.
SMS.
To samo uwierzytelnianie, ten sam format błędów. Uzależnij wysyłkę od wyniku Lookup: odrzuć numery stacjonarne, zanim wygenerują koszty.