2.2. Xác thực OTP
Last updated
Last updated
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
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
Resquest header
Field | Type | Description |
---|---|---|
Resquest body
Field | Type | Description |
---|---|---|
Response body
Field | Type | Description |
---|---|---|
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.
Resquest header
Resquest body
Response body
Bước 1: Đăng ký
Đăng ký sử dụng Email OTP bằng cách liên hệ với phòng Dịch vụ Khách hàng
Bước 2: Lấy OTP bằng email
Sau khi đăng ký thành công với Dịch vụ khách hàng, KH có thể sử dụng API lấy OTP bằng email.
Khi dùng API Email OTP thì mã OTP sẽ được gửi tới địa chỉ email đăng ký khi tạo tại khoản trên Entrade X. Hướng dẫn xem email hiện tại (Lưu ý: Email cần được xác thực trước khi dùng API)
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
Resquest header
Resquest body
Response body
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.
Resquest header
Resquest body
Response body
URL | Method |
---|---|
Field | Type | Description |
---|---|---|
Field | Type | Description |
---|---|---|
Field | Type | Description |
---|---|---|
URL | Method |
---|---|
Field | Type | Description |
---|---|---|
Field | Type | Description |
---|---|---|
Field | Type | Description |
---|---|---|
URL | Method |
---|---|
Field | Type | Description |
---|---|---|
Field | Type | Description |
---|---|---|
Field | Type | Description |
---|---|---|
URL
Method
GET
Authorization
Bearer <JWT token>
N/A
N/A
GET
Authorization
Bearer <JWT token>
otp
String
Mã sms otp lấy từ tin nhắn nhận trong bước 1
N/A
tradingToken
String
Trading token (có hiệu lực trong 8 tiếng)
https://services.entrade.com.vn/entrade-api/email-otp
GET
Authorization
Bearer <JWT token>
N/A
N/A
https://services.entrade.com.vn/entrade-api/otp/trading-token
GET
Authorization
Bearer <JWT token>
otp
String
Mã otp lấy từ API Email OTP (Bước 2)
N/A
tradingToken
String
Trading token (có hiệu lực trong 8 tiếng)