SMS OTP
Verstuur een code via SMS. Controleer op basis van ontvanger.
SMS-verificatie stuurt een eenmalige code naar een telefoonnummer en bevestigt dat de persoon die de code invoert daadwerkelijk de ontvanger is. Bird genereert de code, verstuurt deze, handhaaft limieten per ontvanger en controleert de code op basis van de ontvanger — er is geen id op te slaan en geen apart resend-endpoint om aan te sluiten.
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;
SMS OTP is één call om te versturen en één om te controleren.
SMS is een telefoonkanaal op de Bird Verify API: dien een verificatie in met een telefoonnummer en wij sturen de code via een door Bird beheerde gedeelde afzender, standaard Bird Verify of desgewenst Authifly; controleer de code met datzelfde nummer. Opnieuw indienen van het aanmaakverzoek is de herinzending (create-or-retry), en elke code in de sessie blijft geldig totdat deze verifieert, verloopt of het maximale aantal pogingen bereikt.
Wat u krijgt bij een SMS-verificatie.
Ingebouwd, bij elke verzending.
- 01
Geadresseerd op telefoonnummer.
Geef één E.164-telefoonnummer op. Wij normaliseren het en versturen via SMS op de afzender die voor het betreffende land is vastgesteld.
- 02
Door de server gegenereerde, gehashte codes.
Standaard een 6-cijferige code (4–10 configureerbaar), gegenereerd met een cryptografisch willekeurige bron en uitsluitend opgeslagen als HMAC. U ziet nooit de platte tekst.
- 03
Resend is dezelfde call.
Verstuur het create-verzoek opnieuw om de code nogmaals te verzenden zodra de cooldown van 60 seconden is verstreken: dezelfde sessie, nieuwe code, beide nog geldig. Geen apart resend-endpoint.
- 04
Limieten per ontvanger inbegrepen.
Een verzendlimiet per ontvanger begrenst het verzendvolume en ongecontroleerde kosten, met een 429 en Retry-After.
- 05
Bereik dat per land groeit.
SMS wordt momenteel verzonden via een door Bird beheerde gedeelde afzender, Bird Verify of Authifly, met een branded afzender-ID waar een land dat toestaat en een shortcode of lokaal nummer waar dat vereist is, terwijl dedicated en geregistreerde afzenders het bereik uitbreiden zodra ze beschikbaar komen.
De volledige flow, twee calls.
Create-or-retry stuurt de code naar het telefoonnummer; check bevestigt deze op basis van dat nummer. Er is geen id om tussen de twee te koppelen: de ontvanger is de sleutel.
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;
// data.success is true or false; data.reason elaborates ("incorrect_code", "expired", "attempts_exhausted")De rest van het Verify-platform
Eén API, één set sleutels. Ontdek de overige mogelijkheden.
De verificatie-API waarbij u niets hoeft op te slaan.
SMS is één kanaal van Bird Verify: e-mail en WhatsApp worden meegeleverd, en voice wordt uitgerold — allemaal via dezelfde twee endpoints.