Jedno zapytanie mówi, czym jest numer telefonu: jaka sieć go obsługuje, jaka go wydała, czy został przeniesiony między nimi i jaki to typ linii. Jedno zapytanie mówi, czy adres e-mail przyjmie wiadomość. Ten sam klucz, ta sama koperta błędów, ten sam kontrakt idempotencji co każdy inny kanał Bird — bo wszystko zbudował ten sam zespół inżynierów.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({
apiKey: process.env.BIRD_API_KEY!,
});
const answer = await bird.lookup.phoneNumber({
phone_number: "+31612345678",
type: ["porting", "score"],
});
console.log(answer.country_code, answer.line_type);
// → "NL" "mobile"
console.log(answer.network_info?.carrier_name, answer.flags);
// → "KPN" ["ported"]
// Only a block whose status is ok carries a value,
// and only that one is billed.
if (answer.score?.status === "ok") console.log(answer.score.value);
// → 84
5 minut od npm install do pierwszego wyszukiwania
Sprawdź numer lub adres w języku, którego już używasz.
Typowane metody w SDK dla Go, TypeScript, Python i PHP oraz bird lookup w CLI. Dashboard wykonuje te same dwie operacje pojedynczo — to najszybszy sposób, by zobaczyć odpowiedź, zanim napiszesz jakikolwiek kod.
const answer = await bird.lookup.phoneNumber({
phone_number: "+31612345678",
type: ["classification", "score"],
});
console.log(answer.country_code, answer.line_type);
// Only a block whose status is ok carries a value, and only that one is billed.
if (answer.score?.status === "ok") console.log(answer.score.value);Co zwraca lookup i ile kosztuje każda odpowiedź.
Nazwane pola z rzeczywistych źródeł danych, nie zgadywanie modelu. Każde z nich informuje, czy zostało uzyskane, a płacisz tylko za te, które zostały.
- 01
Kraj i obie sieci
Kraj numeru, sieć obsługująca go dziś i sieć, która wydała jego zakres. Różnią się, gdy numer został przeniesiony.
- 02
Wykrywanie typu linii
Komórkowy, stacjonarny, VoIP, bezpłatny, premium, satelitarny, pager, automat telefoniczny, M2M, usługowy. Zdecyduj, czy SMS jest w ogóle możliwy, zanim go wyślesz.
- 03
Flaga przeniesienia, bezpłatnie z odpowiedzią podstawową
Informacja, czy numer kiedykolwiek zmienił sieć, jest dołączana do każdego lookup. Zażądaj właściwości porting, gdy potrzebujesz też dat i pełnego rekordu.
- 04
Sześć właściwości na żądanie
Name classification, porting, presence, roaming, sim_swap lub score w type. Przypisana usługa zakresu, rekord przeniesienia, czy linia jest aktywna, czy jest w roamingu, kiedy ostatnio zmieniono SIM i wynik wiarygodności od 0 do 100.
- 05
Status przy każdej właściwości
Każdy blok zwraca ok, unavailable lub inconclusive. Tylko ok niesie wartość, więc nigdy nie musisz analizować odpowiedzi, żeby odkryć, że jest pusta.
- 06
Płacisz za odpowiedzi, nie za próby
Podstawowy lookup jest rozliczany raz. Właściwość jest rozliczana tylko wtedy, gdy zostanie dostarczona, a lookup, który się nie powiedzie, nie kosztuje nic.
- 07
Jedno pole, by ocenić adres e-mail
result to valid, neutral, risky, undeliverable lub typo, z reason wyjaśniającym, dlaczego niedostarczalny adres nie może odbierać poczty.
- 08
Korekta błędnie wpisanego adresu
did_you_mean zawiera adres, którego literówka wygląda jak błąd w pisowni. flags oznacza adres roli, jednorazowy lub od darmowego dostawcy, a delivery_confidence ocenia to wszystko w skali od 0 do 100.
- 09
Ponowna próba nie może naliczyć podwójnie
Wyślij Idempotency-Key, a powtórzone żądanie odtworzy odpowiedź, za którą już zapłaciłeś, zamiast kupować drugą.
- 10
Ta sama autoryzacja, ten sam format błędów
Jeden klucz API dla Lookup, SMS, Email, WhatsApp i Verify. Jeden rejestr błędów dla wszystkich i osobny budżet rate-limit, dzięki czemu lookup nigdy nie wchodzi w limit wysyłki.
Dlaczego stworzyliśmy Lookup
Bo nie powinieneś dowiadywać się, że numer jest stacjonarny, obserwując niepowodzenie SMS.
Odpowiedź podstawowa pochodzi z tej samej platformy operatorskiej, która obsługuje SMS i Voice w Bird — dlatego zapytanie kosztuje tak niewiele: już wykonywaliśmy to zapytanie, żeby wybrać trasę w czasie rzeczywistym. Lookup to to samo zapytanie jako pełnoprawny endpoint, dzięki czemu możesz zweryfikować rejestrację, prześwietlić leada lub skierować wiadomość inaczej — bez uprzedniego wysyłania czegokolwiek. Ta sama autoryzacja, ta sama koperta błędów, ten sam kontrakt idempotencji co reszta platformy.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({
apiKey: process.env.BIRD_API_KEY!,
});
const answer = await bird.lookup.phoneNumber({
phone_number: "+31612345678",
type: ["porting", "score"],
});
console.log(answer.country_code, answer.line_type);
// → "NL" "mobile"
console.log(answer.network_info?.carrier_name, answer.flags);
// → "KPN" ["ported"]
// Only a block whose status is ok carries a value,
// and only that one is billed.
if (answer.score?.status === "ok") console.log(answer.score.value);
// → 84
Dwie operacje, po jednej dla każdego typu odbiorcy.
Obie to pojedyncze żądanie i pojedyncza odpowiedź. Nie trzeba niczego tworzyć, niczego odpytywać ani niczego sprzątać po zakończeniu.
Numer telefonu.
Kraj, obie sieci, flaga przeniesienia i typ linii, plus dowolna właściwość podana w type.
Adres e-mail.
Jeden werdykt, wynik pewności, flagi wyjaśniające ryzykowny adres i korekta, gdy wygląda jak literówka.
Poznaj Lookup
Każda operacja w szczegółach. Jeden klucz API, jeden format błędów.
Płacisz za uzyskane odpowiedzi.
Cena za zapytanie: jedna opłata za wyszukiwanie plus jedna za każdą zwróconą właściwość z odpowiedzią. Właściwość, na którą nie możemy odpowiedzieć, oraz nieudane wyszukiwanie są bezpłatne. Bez opłat za stanowisko.