API thuê sim OTP cho phần mềm

API thuê sim OTP cho phép phần mềm của bạn làm những việc vẫn làm bằng tay trên web: xem giá, thuê số, đọc mã, huỷ đơn và gửi tin kích hoạt. Bài này giải thích khi nào nên dùng API, cách bắt đầu và những điểm cần lưu ý để không mất tiền ngoài ý muốn.

Thuê vài số mỗi ngày thì trang web là đủ. API hợp hơn khi:

• Bạn cần nhận mã cho nhiều tài khoản và muốn phần mềm tự chạy, không cần sao chép từng số.
• Bạn là nhà phát triển và muốn kiểm thử luồng đăng ký của ứng dụng bằng số Việt Nam.
• Bạn có công cụ riêng và muốn gắn bước nhận mã vào quy trình sẵn có.

Đơn thuê qua API vẫn hiện trong mục Đơn hàng trên web, nên bạn kiểm tra lại được bất cứ lúc nào.

1. Tạo tài khoản và nạp tiền bằng mã QR như bình thường. API trừ tiền vào cùng số dư đó.
2. Vào trang khoá API, đặt tên khoá, nhập mật khẩu hiện tại rồi bấm Tạo khoá API. Khoá chỉ hiện một lần, bạn lưu lại ngay.
3. Đọc tài liệu API để xem địa chỉ, các trường cần gửi và ví dụ bằng curl, Node.js và Python.

Một vòng thuê số thường gồm bốn bước: lấy danh sách dịch vụ để biết giá, gửi yêu cầu thuê số, hỏi lại đơn vài giây một lần cho tới khi có mã, và huỷ đơn nếu chờ quá lâu.

Quy định hoàn tiền qua API giống hệt trên web. Hết giờ mà chưa có mã, đơn tự chuyển sang hết hạn và hoàn tiền 100% vào số dư. Nếu không muốn chờ, phần mềm gửi yêu cầu huỷ khi đơn đã chạy được 30 giây để nhận lại tiền ngay. Đơn đã có mã thì được tính tiền và không hoàn lại.

• Gửi kèm giá cao nhất bạn chấp nhận. Nếu giá vừa tăng, đơn không được tạo và bạn biết giá mới trước khi bị trừ tiền.
• Đặt thời gian chờ của phần mềm từ 130 giây cho yêu cầu thuê số. Nếu mất kết nối giữa chừng, bạn xem danh sách đơn đang chờ trước khi thuê lại, tránh thuê trùng hai số.
• Hỏi lại trạng thái đơn mỗi 3 đến 5 giây là đủ. Hỏi liên tục hơn không làm mã về nhanh hơn.
• Theo dõi nhiều đơn bằng một yêu cầu lấy danh sách đơn đang chờ, thay vì hỏi từng đơn.

Ai có khoá API đều thuê số được bằng số dư của bạn, nên khoá cần được giữ như mật khẩu. Bạn chỉ đặt khoá trên máy chủ của mình, không đưa vào mã chạy trên trình duyệt hay kho mã công khai. Nếu nghi khoá bị lộ, bạn bấm Thu hồi trong trang khoá API, khoá ngừng hoạt động ngay. Đổi mật khẩu cũng thu hồi mọi khoá, sau đó bạn tạo khoá mới.

Điều khoản sử dụng áp dụng cho cả web và API. Số thuê không được dùng để lừa đảo, gửi tin rác, mạo danh hay làm trái pháp luật. Với tài khoản cần giữ lâu dài như ngân hàng hay ví điện tử, bạn nên đổi sang số của chính mình sau khi xác minh.

Bạn có thể xem giá từng ứng dụng trên bảng giá trước khi viết dòng mã đầu tiên.