2.2. Xác thực OTP
Entrade cung cấp 2 phương thức để xác thực OTP cho giao dịch qua API, có thể sử dụng một trong 2 phương thức này để xác thực:
Xác thực bằng SMS OTP
Xác thực bằng Email OTP
Xác thực bằng SMS OTP
Bước 1: Lấy SMS OTP thông qua API
Khi dùng API SMS OTP thì mã OTP sẽ được gửi tới số điện thoại đăng ký khi tạo tại khoản trên Entrade X (DNSE).
Mã OTP sẽ có hiệu lực trong vòng 2 phút và chỉ dùng được 1 lần, khi dùng xong hoặc hết hiệu lực thì cần dùng API này để lấy mã mới
URL
Method
GET
Resquest header
Authorization
Bearer <JWT token>
Resquest body
N/A
Response body
N/A
Bước 2: Xác thực OTP
Sau khi xác thực OTP thành công, hệ thống sẽ cấp trading-token
Trading token sẽ được sử dụng trong các API chỉnh sửa dữ liệu: đặt lệnh, huỷ lệnh
Trading token sẽ có hiệu lực trong vòng 8h, khi hết hiệu lực cần dùng API này để xác thực và lấy lại trading-token mới.
GET
Resquest header
Authorization
Bearer <JWT token>
otp
String
Mã sms otp lấy từ tin nhắn nhận trong bước 1
Resquest body
N/A
Response body
tradingToken
String
Trading token (có hiệu lực trong 8 tiếng)
Xác thực bằng Email OTP
Bước 1: Đăng ký
Bước 2: Lấy OTP bằng email
Sau khi đăng ký thành công, Khách hàng có thể sử dụng API lấy OTP bằng email.
Mã OTP sẽ có hiệu lực trong vòng 2 phút và chỉ dùng được 1 lần, khi dùng xong hoặc hết hiệu lực thì cần dùng API này để lấy mã mới
https://services.entrade.com.vn/entrade-api/email-otp
GET
Resquest header
Authorization
Bearer <JWT token>
Resquest body
N/A
Response body
N/A
Bước 3: Xác thực OTP
Sau khi xác thực OTP thành công, hệ thống sẽ cấp trading-token
Trading token sẽ được sử dụng trong các API chỉnh sửa dữ liệu: đặt lệnh, huỷ lệnh
Trading token sẽ có hiệu lực trong vòng 8h, khi hết hiệu lực cần dùng API này để xác thực và lấy lại trading-token mới.
https://services.entrade.com.vn/entrade-api/otp/trading-token
GET
Resquest header
Authorization
Bearer <JWT token>
otp
String
Mã otp lấy từ API Email OTP (Bước 2)
Resquest body
N/A
Response body
tradingToken
String
Trading token (có hiệu lực trong 8 tiếng)
Last updated