SMS OTP
Kirim kode via SMS. Cek berdasarkan penerima.
Verifikasi SMS mengirimkan kode sekali pakai ke nomor telepon dan mengonfirmasi bahwa orang yang memasukkannya kembali adalah pemegang nomor tersebut. Bird membuat kode, mengirimkannya, menerapkan batas per penerima, dan memverifikasinya berdasarkan penerima — jadi tidak ada id yang perlu disimpan dan tidak ada endpoint resend yang perlu dihubungkan.
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 hanya butuh satu panggilan untuk mengirim dan satu untuk memeriksa.
SMS adalah kanal keluarga telepon pada Bird Verify API: kirimkan verifikasi dengan nomor telepon dan kami akan mengirim kode melalui pengirim bersama yang dikelola Bird, Bird Verify secara default atau Authifly jika Anda lebih suka; verifikasi dengan nomor yang sama. Mengirim ulang permintaan create adalah resend (create-or-retry), dan setiap kode dalam sesi tetap valid hingga terverifikasi, kedaluwarsa, atau kehabisan percobaan.
Apa yang Anda dapatkan dari verifikasi SMS.
Sudah terintegrasi, di setiap pengiriman.
- 01
Ditujukan berdasarkan nomor telepon.
Masukkan satu nomor telepon E.164. Kami menormalisasinya dan mengirim melalui SMS pada pengirim yang ditetapkan untuk negaranya.
- 02
Kode yang dihasilkan server dan di-hash.
Kode 6 digit secara default (dapat dikonfigurasi 4–10), dihasilkan dari sumber acak kriptografis dan hanya disimpan sebagai HMAC. Anda tidak pernah melihat teks aslinya.
- 03
Pengiriman ulang menggunakan panggilan yang sama.
Kirim ulang permintaan create setelah masa tunggu 60 detik berlalu: sesi yang sama, kode baru, keduanya tetap valid. Tidak ada endpoint resend terpisah.
- 04
Batas per penerima sudah termasuk.
Batas pengiriman per penerima membatasi volume pengiriman dan pengeluaran tak terkendali, menghasilkan respons 429 dengan Retry-After.
- 05
Jangkauan yang meluas per negara.
SMS saat ini dikirim melalui pengirim bersama yang dikelola Bird, Bird Verify atau Authifly, menampilkan sender ID bermerek di negara yang mengizinkannya serta short code atau nomor lokal di negara yang mewajibkannya, dengan pengirim khusus dan terdaftar yang memperluas jangkauan seiring tersedianya.
Seluruh alur, dua panggilan.
Create-or-retry mengirimkan kode ke nomor telepon; check mengonfirmasinya berdasarkan nomor tersebut. Tidak ada id yang perlu dihubungkan di antara keduanya: penerima adalah kuncinya.
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")Platform Verify lainnya
Satu API, satu set kunci. Jelajahi kemampuan lainnya.
API verifikasi tanpa perlu menyimpan apa pun.
SMS adalah salah satu kanal dari Bird Verify: email dan WhatsApp sudah tersedia bersamanya, dan voice sedang diluncurkan — semuanya pada dua endpoint yang sama.