Orkiestracja kanałów
Bird ustala wartości domyślne. Ty dostosowujesz pojedyncze wywołanie.
Dostępność kanałów, reguły nadawców i regulacje różnią się w zależności od kraju, a ich prawidłowe skonfigurowanie to lata pracy. Bird dostarcza to jako bazę per-kraj: które kanały działają gdzie, którzy nadawcy są dozwoleni i rozsądne domyślne ustawienia kodów — wypracowane na podstawie obsługi e-maili i SMS na dużą skalę. Wywołanie create automatycznie rozwiązuje się do właściwego planu dla dowolnego kraju, a pole opcji pozwala zmienić kolejność lub zawęzić kanały bądź ustawić długość kodu dla tej jednej weryfikacji.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({
apiKey: process.env.BIRD_API_KEY!,
});
// Send the code, then check it by recipient.
await bird.verify.verifications.create({
to: { phone_number: "+15551234567" },
}).safe();
const { data, error } = await bird.verify.verifications.check({
to: { phone_number: "+15551234567" },
code: userInput,
}).safe();
if (error) throw error;
Twoje konto
Potwierdź, że to Ty.
Wpisz kod wysłany na
+1 ••• ••• 4567Przykładowy kod weryfikacyjny
Zaufanie zespołów, które tworzą oprogramowanie najwyższej klasy
Poznaj więcej historii klientówDomyślne ustawienia Bird towarzyszą każdemu wywołaniu.
Każda weryfikacja w Bird Verify API jest rozwiązywana względem bazy per-kraj, którą Bird utrzymuje na podstawie lat obsługi e-maili i SMS, więc weryfikacja jest prawidłowo kierowana w każdym kraju, zanim napiszesz choćby linijkę kodu. Opcja w żądaniu wciąż może dostosować pojedyncze wywołanie: zmienić kolejność lub zawęzić kanały albo ustawić długość kodu. Nigdy nie zaczynasz od zera.
Plan ustalają dwie warstwy.
Wygrywa węższa warstwa; to, czego żądanie nie ustawia, przechodzi do bazy per-kraj Bird.
- 01
Opcje per żądanie.
Przekaż channels lub code_length w wywołaniu create, aby zmienić kolejność lub zawęzić kanały bądź ustawić długość kodu dla tej jednej weryfikacji. Pomiń dowolny parametr, a zastosowane zostaną domyślne ustawienia kraju.
- 02
Baza Bird per kraj.
Własne domyślne ustawienia Bird dla poszczególnych krajów, wypracowane na podstawie obsługi e-maili i SMS na dużą skalę: które kanały są dostępne, którzy nadawcy są dozwoleni oraz rozsądne domyślne wartości kodów i TTL. To, czego żądanie nie nadpisuje, jest rozwiązywane z tej bazy, więc weryfikacja zawsze trafia na rozsądny plan.
Do czego rozwiązuje się weryfikacja.
Numer brazylijski jest rozwiązywany względem bazy per-kraj Bird dla Brazylii, zawężonej o ewentualne opcje w żądaniu. WhatsApp i SMS są tam dostępne, więc weryfikacja zwraca ten uporządkowany plan wraz z typowanym identyfikatorem vrf_.
const { data, error } = await bird.verify.verifications.create({
to: { phone_number: "+5511998765432" }, // Brazil
}).safe();
if (error) throw error;
// Resolved from the per-country base, capped by availability and the kill-switch:
// {
// id: "vrf_01k2m9q8e7fh3v0b7m4d2a9xzt",
// status: "pending",
// channels: [{ channel: "whatsapp" }, { channel: "sms" }],
// last_channel: "whatsapp"
// }
Nad wartościami domyślnymi stoją dwa ograniczenia.
Dwie powyższe warstwy ustalają wartości domyślne. Dwie bramki decydują, co jest dozwolone ponad to, a każda z nich jedynie zawęża rozwiązany plan:
Dostępność per-kraj. Rozwiązany plan kraju zawiera wyłącznie kanały, które Bird faktycznie tam oferuje. Opcje żądania mogą zmienić kolejność lub zawęzić ten plan; nie mogą dodać kanału, którego kraj nie obsługuje, ponieważ dostępność działa na zasadzie części wspólnej.
Globalny wyłącznik awaryjny. Gdy dostawca ma awarię, Bird może wycofać kanał wszędzie jednocześnie. Rozwiązany plan po prostu przechodzi na następny kanał, a po usunięciu blokady automatycznie przywraca poprzedni.
Plan jest w każdej odpowiedzi.
Rozwiązywany per weryfikacja, zwracany w odpowiedzi.
- 01
Rozwiązany plan jest w odpowiedzi.
Każda weryfikacja zwraca uporządkowane kanały, do których została rozwiązana, więc rozwiązany plan nigdy nie jest tajemnicą.
- 02
Automatyczne przełączanie awaryjne realizuje plan za Ciebie.
Kanał, który zawiedzie, przekazuje weryfikację do następnego w planie, a timer dostarczenia dla każdej próby przełącza ją, gdy status dostarczenia w ogóle nie nadejdzie. Każdy kod w sesji pozostaje ważny, więc odbiorca może użyć dowolnej wiadomości, która do niego dotrze. Możesz też przekazać weryfikację na żądanie, wywołując przełączenie na następny kanał.
Zastosuj w praktyce.
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Reszta platformy Verify
Jedno API, jeden zestaw kluczy. Poznaj pozostałe możliwości.
Domyślne ustawienia per-kraj, których nie musisz budować samodzielnie.
Domyślne ustawienia per-kraj to jedna z możliwości Bird Verify: kanały, kod i limity są dostarczane w pakiecie, w tych samych wywołaniach create i check.