API/1. Khởi tạo xác thực
2 min read
1. Khởi tạo xác thực
Khởi tạo phiên xác minh mới và kích hoạt máy chủ kết nối.
Hệ thống ReOTP dùng tính năng đánh thức theo yêu cầu để tiết kiệm tài nguyên server. Kết nối WhatsApp của bạn sẽ ngủ, khi bạn gửi yêu cầu này, server thức dậy mở kết nối sẵn sàng nhận tin nhắn khách hàng.
Tham số gửi (Request Body):
apiKey(chuỗi - bắt buộc): API Key dự án.
phoneNumber(chuỗi - bắt buộc): Số điện thoại người dùng (VD:+84900000000).
method(chuỗi - tùy chọn): Phương thức"WHATSAPP"hoặc"TELEGRAM"(mặc định:"WHATSAPP").
returnUrl(chuỗi - tùy chọn): URL chuyển hướng sau khi xác thực thành công trên Telegram.
Tham số nhận (Response Body):
requestId(chuỗi): ID duy nhất theo dõi trạng thái.
waLink(chuỗi): Link WhatsApp (chỉ trả về nếu methodWHATSAPP).
tgLink(chuỗi): Link Telegram (chỉ trả về nếu methodTELEGRAM).
expectedText(chuỗi): Nội dung tin nhắn tự động phải gửi.
expiresIn(chuỗi): Thời gian hết hạn yêu cầu (2 phút).
Lưu ý quan trọng:
- Thời gian hiệu lực: Khách chỉ có 2 phút (02:00) mở link và gửi tin nhắn tự động trước khi phiên hết hạn và server ngủ lại.
- Giao diện: Khuyến khích hiển thị đồng hồ đếm ngược (Countdown) để thúc khách gửi tin nhanh.
Gửi yêu cầu POST đến endpoint ở bảng code bên cạnh để bắt đầu.
Integration Code (SDKs)
Interactive Playground
Nền tảng tương tác kiểm thử API
Nhập số điện thoại để khởi tạo phiên và kiểm tra phản hồi server tức thì:
Sân chơi API tương tác trực tiếp (Interactive API Playground)
Thử gửi yêu cầu xác thực trực tiếp và tạo code tích hợp ngôn ngữ bạn thích.
curl -X POST https://reotp.com/api/verify/init \
-H "Authorization: Bearer 15a1c1c7-ed05-40df-b7c3-69c327542a07" \
-H "Content-Type: application/json" \
-d '{
"phoneNumber": "201000000000",
"method": "WHATSAPP"
}'