Wyślij kod przez SMS. Sprawdź go po odbiorcy.

Konfiguracja w:

Weryfikacja SMS wysyła jednorazowy kod na numer telefonu i potwierdza, że osoba wpisująca go z powrotem jest jego właścicielem. Bird generuje kod, wysyła go, egzekwuje limity na odbiorcę i weryfikuje kod po odbiorcy — nie trzeba przechowywać żadnego identyfikatora ani podpinać osobnego endpointu ponownego wysyłania.

verify.ts

200 · pending

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 } = await bird.verify.verifications.check({
  to:   { phone_number: "+15551234567" },
  code: userInput,
}).safe();

verify.ts

200 · pending

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 } = await bird.verify.verifications.check({
  to:   { phone_number: "+15551234567" },
  code: userInput,
}).safe();

SMS OTP to jedno wywołanie do wysłania i jedno do sprawdzenia.

SMS to kanał telefoniczny w Bird Verify API: wyślij weryfikację z numerem telefonu, a my dostarczymy kod przez współdzielony nadawcę SMS Authifly; sprawdź go po tym samym numerze. Ponowne wysłanie żądania tworzenia to ponowna wysyłka (utwórz-lub-ponów), a każdy kod w sesji pozostaje ważny, dopóki nie zostanie zweryfikowany, nie wygaśnie lub nie wyczerpie limitu prób.

Co otrzymujesz przy weryfikacji SMS.

Wbudowane, przy każdej wysyłce.

01
Adresowanie po numerze telefonu.
Podaj pojedynczy numer telefonu w formacie E.164. Normalizujemy go i wysyłamy SMS przez nadawcę przypisanego do danego kraju.
02
Kody generowane na serwerze, przechowywane jako hash.
Domyślnie 6-cyfrowy kod (konfigurowalny od 4 do 10 cyfr), generowany z kryptograficznego źródła losowego i przechowywany wyłącznie jako HMAC. Nigdy nie widzisz tekstu jawnego.
03
Ponowna wysyłka to to samo wywołanie.
Ponów żądanie create, aby wysłać kod ponownie po upływie 60-sekundowego odstępu: ta sama sesja, nowy kod, oba wciąż ważne. Bez osobnego endpointu ponownego wysyłania.
04
Limity na odbiorcę w zestawie.
Limit wysyłek na odbiorcę ogranicza wolumen wysyłek i niekontrolowane koszty — zwraca 429 z Retry-After.
05
Zasięg rosnący z każdym krajem.
SMS jest obecnie wysyłany przez współdzielonego nadawcę Authifly, z dostarczalnością w krajach, w których jest zarejestrowany. Dedykowani i zarejestrowani nadawcy rozszerzają zasięg w miarę ich uruchamiania.

Cały przepływ, dwa wywołania.

Create-or-retry wysyła kod na numer telefonu; check potwierdza go na podstawie tego numeru. Nie ma żadnego identyfikatora do przekazywania między nimi: kluczem jest odbiorca.

sms-otp.ts

200

await bird.verify.verifications.create({
  to: { phone_number: "+15551234567" },
}).safe();

const { data } = await bird.verify.verifications.check({
  to:   { phone_number: "+15551234567" },
  code: userInput,
}).safe();

// data.result is true or false; data.reason elaborates ("expired", "already_verified", …)

SMS OTP FAQ

Czym jest SMS OTP?

Jednorazowy kod SMS to krótki kod wysyłany na numer telefonu, który użytkownik wpisuje z powrotem, aby udowodnić, że kontroluje ten numer. To najczęściej stosowany drugi składnik uwierzytelniania i weryfikacja przy rejestracji, ponieważ niemal każdy telefon odbiera SMS.

Czy muszę przechowywać identyfikator weryfikacji, aby sprawdzić kod?

Nie. Bird weryfikuje po odbiorcy: wysyłasz numer telefonu i kod, a my rozwiązujemy aktywną sesję na podstawie pary konfiguracja-numer. Identyfikator konfiguracji jest stały; żadne dane nie są przechowywane dla pojedynczej weryfikacji.

Do jakich krajów mogę wysyłać?

SMS jest wysyłany przez współdzielonego nadawcę Authifly, który dostarcza wiadomości w krajach, w których jest zarejestrowany. Zasady Sender-ID są specyficzne dla danego kraju, a zarejestrowani i dedykowani nadawcy z czasem rozszerzają zasięg.

Jak zapobiegacie SMS pumping i atakom brute force?

Limity wysyłek na odbiorcę oraz limit prób zgadywania na weryfikację są wbudowane. Głębsze sygnały oszustw i ochrona przed SMS pumping są w przygotowaniu.

Od kogo moi użytkownicy widzą kod?

Authifly — marka weryfikacyjna Bird. To tożsamość na każdym kodzie, który otrzymują Twoi użytkownicy: e-mail przychodzi z otp@verify.authifly.com lub Twojej własnej zweryfikowanej domeny, a SMS i WhatsApp są oznaczone marką Authifly. authifly.com to publiczna strona, która zapewnia odbiorców, że Authifly wysyła legalne jednorazowe kody w imieniu firmy. Bird to platforma, na której budujesz; Authifly to to, co widzi odbiorca.

Reszta platformy Verify

Jedno API, jeden zestaw kluczy. Poznaj pozostałe możliwości.

Email OTPWeryfikuj przez e-mail w sieci, która już obsługuje Twoją pocztę transakcyjną.WhatsApp OTPKody przez WhatsApp jako konfigurowalny kanał w tym samym planie.Voice OTPW przygotowaniu: kod głosowy dla telefonów stacjonarnych i trudno dostępnych użytkowników.Orkiestracja kanałówKolejność kanałów i nadawcy per kraj jako pełnoprawny zasób konfiguracyjny.Ochrona przed nadużyciami i bezpieczeństwo kodówHashowane kody, limity per odbiorca, blokada po nieudanych próbach i plan przeciwdziałania oszustwom.Przegląd Verify APIPełne Verify API: tworzenie lub ponawianie, weryfikacja po celu i konfiguracja per kraj.

API weryfikacji, które nie wymaga przechowywania danych.

SMS to jeden z kanałów Bird Verify: e-mail i WhatsApp są dostępne od razu, a kanał głosowy jest wdrażany — wszystko na tych samych dwóch endpointach.

Poznaj platformę Verify Rozpocznij