Terima SMS melalui API atau dasbor: alur kerja mana yang cocok?

Pertama, bedakan tiga API yang berbeda

API penerimaan nomor sementara memesan atau menyewa nomor lalu mengambil SMS masuk untuk pesanan tersebut. Dasbor manual menyajikan jenis pesanan dan pesan yang sama kepada seseorang di browser. API pengiriman atau verifikasi, seperti Twilio Verify, memulai verifikasi dengan mengirim kode ke perangkat pengguna sendiri. Produk-produk ini berada di sisi berlawanan dari pesan. Mencari “SMS verification API” dapat mengembalikan salah satunya, jadi verifikasi arah sebelum memilih dokumentasi.

OTPAtlas saat ini menawarkan dasbor yang sudah masuk untuk memilih dan mengikuti pesanan nomor sementara. Ini tidak menawarkan API publik yang terdokumentasi untuk pengembang eksternal. Contoh penyedia di bawah ini menunjukkan bagaimana API eksternal yang terdokumentasi berbeda dari dasbor manual; itu bukan endpoint OTPAtlas.

Sumber: 5SIM receiving API docs · SMSPool order/check API guide · Twilio Verify sending API

Kapan dasbor menjadi alat yang lebih baik

Untuk satu kode sesekali, dasbor menjaga keputusan manusia tetap terlihat: konfirmasi aturan layanan penerima, bandingkan negara yang diizinkan, baca harga dan stok langsung, danai akun bila perlu, dan tinjau pesanan yang tepat sebelum konfirmasi. Di OTPAtlas, tab SMS kemudian menampilkan nomor yang ditetapkan, kedaluwarsa tepat setelah penetapan, status, dan pesan yang tercatat; Riwayat dan aktivitas saldo menunjukkan hasil akhir. Tidak diperlukan integrasi perangkat lunak untuk mengajukan pertanyaan tersebut.

API tidak membuat negara yang dikecualikan menjadi memenuhi syarat, menciptakan stok, memperpanjang nomor pendek, atau memastikan bahwa platform pihak ketiga menerimanya. Jika bagian tersulit adalah memilih nomor yang tepat atau memahami kredit tanpa pesan, otomatisasi mungkin hanya mengulangi pilihan buruk lebih cepat. Gunakan dasbor sampai keputusan itu sendiri dipahami dan diulang cukup untuk membenarkan kode.

Apa yang sebenarnya didokumentasikan oleh API penerima yang didukung

Dokumentasi resmi 5SIM memisahkan produk dan harga, membeli nomor aktivasi, memeriksa pesanan untuk SMS, menyelesaikan dan membatalkan, serta status. Ketentuan publiknya tetap mengikat pembeli yang menggunakan API, termasuk pembatasan kelayakan AS/Rusia. Panduan SMSPool mendokumentasikan ID pesanan, pemeriksaan status untuk kode yang tertunda atau selesai, pembatalan, dan respons kesalahan seperti stok habis atau saldo tidak mencukupi. OnlineSIM mendokumentasikan endpoint aktivasi dan sewa. HeroSMS mengarahkan pengguna ke dokumentasi API-nya dan menerbitkan batas permintaan dalam aturannya, sementara kompatibilitas SMS-Activate yang diklaimnya belum diuji di sini.

Ini adalah kontrak khusus penyedia. Jangan menempelkan nama parameter, nomor status, atau logika pengembalian dana dari satu penyedia ke integrasi lain. Gunakan dokumentasi terkini untuk penyedia dan produk yang benar-benar Anda pilih, termasuk apakah API mendukung pilihan negara, operator, dan penyewaan yang sama seperti yang Anda lihat di dasbornya.

Sumber: 5SIM API documentation · 5SIM terms · SMSPool API order/check guide · OnlineSIM API products · HeroSMS API and rules

Rancang siklus hidup pesanan sebelum mengotomatiskannya

Alur konseptual yang aman adalah: baca produk dan harga terkini; pastikan akun memenuhi syarat dan didanai; kirim satu pesanan; simpan ID pesanan yang dikembalikan; periksa pesanan yang sama untuk status menunggu, SMS diterima, dibatalkan, atau kedaluwarsa; dan rekonsiliasi setiap pergerakan saldo. Jika penyedia menawarkan pembatalan, terapkan waktu aktual dan aturan tanpa pesan. Panduan SMSPool secara eksplisit memberi tahu integrator untuk menyimpan ID pesanan dan melakukan polling ke endpoint pemeriksaan karena tidak mengirim notifikasi push untuk alur tersebut.

Batas waktu permintaan setelah pengiriman pesanan bersifat ambigu: penyedia mungkin telah membuat pesanan meskipun klien Anda tidak pernah melihat responsnya. Jangan langsung mengirimkan permintaan pembelian berbayar kedua. Periksa dulu riwayat pesanan atau fasilitas status penyedia dan rekonsiliasi dengan catatan permintaan lokal. Kami tidak menemukan kunci idempotensi terdokumentasi yang umum untuk penyedia ini; tanyakan apakah endpoint yang dipilih mendukungnya. Ini adalah tindakan pencegahan rekayasa, bukan janji perilaku penyedia.

Sumber: 5SIM order and history API · SMSPool order ID, status and polling

Menangani kesalahan, batas laju, dan rahasia sebagai keputusan produk

Stok habis berarti produk yang dipilih tidak tersedia; saldo tidak mencukupi berarti perlu pendanaan. Keduanya bukan isyarat untuk otomatis membeli negara lain jika platform penerima melarangnya. SMSPool mendokumentasikan jenis respons tersebut. 5SIM menerbitkan batas permintaan dan respons 429 atau 503 untuk batas yang berbeda; HeroSMS menerbitkan batas permintaan API dalam aturannya saat ini. Baca ambang batas penyedia saat ini dan gunakan percobaan ulang atau backoff terkendali untuk pemeriksaan status, sambil menghindari percobaan ulang panggilan pembelian yang tidak terkendali.

Simpan kunci API di server tepercaya, bukan di halaman browser publik, batasi akses ke log yang berisi nomor telepon atau teks pesan, dan simpan hanya yang dibutuhkan alur kerja. Lacak ID pesanan dan hasil akhirnya agar pertanyaan dukungan dapat mengidentifikasi peristiwa tertentu. Pengguna dasbor tidak perlu membangun kontrol ini; pengembang yang menggunakan API perlu. Tidak ada antarmuka yang memberikan izin untuk melewati aturan platform penerima.

Sumber: Kesalahan API SMSPool · 5SIM batas API · Aturan API HeroSMS

Dua pilihan lengkap

Kasus A: seseorang membutuhkan satu kode yang diizinkan minggu ini. Mereka dapat menggunakan dasbor OTPAtlas untuk memeriksa penawaran layanan-negara yang aktif, mendanai hanya setelah memahami top-up minimum, mengonfirmasi pesanan dan membaca status SMS. Membangun integrasi API akan menambah pekerjaan kredensial dan penanganan kesalahan tanpa mengubah kelayakan atau durasi nomor tersebut.

Kasus B: sebuah tim menguji alur pendaftaran mereka sendiri yang disetujui di negara-negara yang diizinkan secara berulang. Penyedia dengan API penerimaan resmi dapat mengurangi penyalinan manual jika tim dapat mengimplementasikan siklus hidup pesanan, melindungi kredensial, merekonsiliasi pembelian yang ambigu dan mematuhi batas laju. Jika tim justru perlu mengirim kode verifikasi ke penggunanya sendiri, mereka harus memeriksa produk pengiriman seperti Twilio Verify, bukan API penerimaan nomor sementara.

Sumber: 5SIM receiving API · Twilio Verify sending API

Pertanyaan umum