PortSMS

Terima SMS di server Anda dengan webhook

Dapatkan setiap SMS yang diterima nomor sewaan Anda dikirim langsung ke endpoint HTTPS Anda, dan verifikasi bahwa SMS itu berasal dari PortSMS.

Mengapa webhook

Polling API memang bisa, tetapi webhook mengirim setiap SMS dalam hitungan detik tanpa kode Anda harus bertanya berulang kali.

Cara mengaturnya

Buka halaman Kunci API, masukkan alamat HTTPS di domain publik, lalu simpan. Signing secret hanya ditampilkan sekali: simpan bersama rahasia server Anda yang lain.

Apa yang Anda terima

Sebuah POST dengan body JSON: event sms.received dan data berisi id sewa, nomor telepon, pengirim, teks lengkap, kode yang terdeteksi, dan waktu diterima.

Verifikasi setiap permintaan

Baca header X-PortSMS-Signature, hitung HMAC-SHA256 dari "t.body" dengan secret Anda, lalu bandingkan dengan v1 secara constant time. Tolak permintaan yang nilai t-nya lebih dari 5 menit.

Balas dengan cepat

Balas dengan status 2xx segera setelah pesan tersimpan, lalu kerjakan proses yang lambat setelahnya. Respons lain akan dicoba ulang hingga 8 kali.

Panduan