Vì sao dùng webhook
Gọi API định kỳ vẫn được, nhưng webhook gửi từng SMS trong vài giây mà mã của bạn không phải hỏi đi hỏi lại.
Cài đặt
Mở trang Khóa API, nhập một địa chỉ HTTPS trên tên miền công khai và lưu. Signing secret chỉ hiển thị một lần: hãy lưu cùng các thông tin bí mật khác của máy chủ.
Bạn nhận được gì
Một yêu cầu POST với body JSON: event sms.received và data gồm id lượt thuê, số điện thoại, người gửi, toàn bộ nội dung, mã được phát hiện và thời gian nhận.
Xác minh mọi yêu cầu
Đọc header X-PortSMS-Signature, tính HMAC-SHA256 của "t.body" bằng secret của bạn và so sánh với v1 theo thời gian không đổi (constant time). Từ chối các yêu cầu có t cũ hơn 5 phút.
Phản hồi nhanh
Trả về mã trạng thái 2xx ngay khi đã lưu tin nhắn, rồi mới xử lý các việc chậm. Mọi phản hồi khác sẽ được thử lại tối đa 8 lần.