Đăng nhập và lấy JWT

POST

https://platform.verolabs.co

api

auth

Đăng nhập bằng mật khẩu

curl --request POST \
  --url https://platform.verolabs.co/api/auth/login \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifier": "<string>",
  "password": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({identifier: '<string>', password: '<string>'})
};

fetch('https://platform.verolabs.co/api/auth/login', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://platform.verolabs.co/api/auth/login"

payload = {
    "identifier": "<string>",
    "password": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.verolabs.co/api/auth/login"

	payload := strings.NewReader("{\n  \"identifier\": \"<string>\",\n  \"password\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

using RestSharp;


var options = new RestClientOptions("https://platform.verolabs.co/api/auth/login");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddJsonBody("{\n  \"identifier\": \"<string>\",\n  \"password\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://platform.verolabs.co/api/auth/login");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"identifier\": \"<string>\",\n  \"password\": \"<string>\"\n}");

CURLcode ret = curl_easy_perform(hnd);

{
  "status": "authenticated",
  "sessionToken": "<session-token>",
  "jwt": "<jwt>",
  "session": {
    "active": true,
    "authenticator_assurance_level": "aal1",
    "tokenized": "<jwt>"
  },
  "identity": null,
  "tokenizedSession": {
    "active": true,
    "authenticator_assurance_level": "aal1",
    "tokenized": "<jwt>"
  }
}

Gửi yêu cầu xác thực đến https://platform.verolabs.co. Dùng JWT nhận được để gọi REST API cần xác thực tại https://api-oms.verolabs.co.

Trạng thái phản hồi

Cả hai trạng thái dưới đây đều trả HTTP 200. Kiểm tra status trước khi đọc jwt.

`status`	Ý nghĩa	Bước tiếp theo
`authenticated`	Đã đáp ứng tất cả yếu tố xác thực bắt buộc. Phản hồi chứa `jwt` và `sessionToken`.	Gửi `jwt` qua `Authorization: Bearer <jwt>` khi gọi REST API.
`mfa_required`	Cần xác thực yếu tố thứ hai. Phản hồi chứa `methods` và `expiresAt`, không chứa `jwt` hoặc `sessionToken`.	Giữ cookie phản hồi và xác minh yếu tố thứ hai.

Khi tài khoản bật xác thực hai lớp, xác minh mật khẩu chưa đủ để cấp JWT. Ví dụ phản hồi yêu cầu xác thực đang chờ:

{
  "status": "mfa_required",
  "methods": ["totp", "lookup_secret"],
  "expiresAt": "2026-10-20T12:00:00Z"
}

methods liệt kê phương thức khả dụng cho yêu cầu xác thực này. totp nhận mã 6 chữ số hiện tại trong ứng dụng xác thực. lookup_secret nhận mã dự phòng đã lưu và chưa sử dụng. Chọn phương thức có trong phản hồi API.

Đăng nhập bằng cURL

Các ví dụ Bash dưới đây cần curl và jq. Dùng cùng một cookie jar cho bước đăng nhập và xác minh. Yêu cầu từ trình duyệt phải cùng origin với máy chủ xác thực; yêu cầu khác origin bị từ chối.

1. Gửi email và mật khẩu

AUTH_BASE_URL="https://platform.verolabs.co"
COOKIE_JAR="$(mktemp)"
chmod 600 "$COOKIE_JAR"
read -r -p "Email tài khoản: " IDENTIFIER
read -r -s -p "Mật khẩu: " PASSWORD
printf '\n'

AUTH_RESPONSE="$(curl --silent --show-error --fail-with-body \
  --request POST "$AUTH_BASE_URL/api/auth/login" \
  --cookie-jar "$COOKIE_JAR" \
  --header 'Content-Type: application/json' \
  --data "$(jq -n --arg identifier "$IDENTIFIER" --arg password "$PASSWORD" \
    '{identifier: $identifier, password: $password}')")"
unset PASSWORD

printf '%s\n' "$AUTH_RESPONSE" | jq '{status, methods, expiresAt}'

Nếu status là authenticated, chuyển đến bước 3. Nếu là mfa_required, hoàn tất bước 2 trước khi lấy JWT.

2. Xác minh yếu tố thứ hai khi được yêu cầu

Với totp, nhập mã 6 chữ số hiện tại trong ứng dụng xác thực. Giữ mã dưới dạng chuỗi để không mất số 0 ở đầu.

MFA_METHOD="totp"
read -r -s -p "Mã trong ứng dụng xác thực: " MFA_CODE
printf '\n'

AUTH_RESPONSE="$(curl --silent --show-error --fail-with-body \
  --request POST "$AUTH_BASE_URL/api/auth/mfa/verify" \
  --cookie "$COOKIE_JAR" \
  --cookie-jar "$COOKIE_JAR" \
  --header 'Content-Type: application/json' \
  --data "$(jq -n --arg method "$MFA_METHOD" --arg code "$MFA_CODE" \
    '{method: $method, code: $code}')")"
unset MFA_CODE

printf '%s\n' "$AUTH_RESPONSE" | jq '{status, aal: .session.authenticator_assurance_level}'

Để dùng mã dự phòng, đặt MFA_METHOD="lookup_secret" và nhập mã dự phòng đã lưu, chưa sử dụng. Chỉ chọn cách này khi lookup_secret có trong methods. Xác minh thành công sẽ tiêu thụ mã dự phòng đó. Phản hồi thành công có status: "authenticated", JWT và authenticator_assurance_level: "aal2" trong các đối tượng phiên. API xoá cookie xác thực đang chờ.

3. Gọi REST API bằng JWT

JWT="$(printf '%s\n' "$AUTH_RESPONSE" \
  | jq -er 'select(.status == "authenticated") | .jwt')"

curl --silent --show-error --fail-with-body \
  --header "Authorization: Bearer $JWT" \
  'https://api-oms.verolabs.co/api/v1/oms/risk/accounts'

rm -- "$COOKIE_JAR"
unset AUTH_RESPONSE JWT

sessionToken và jwt có mục đích khác nhau. Dùng jwt để xác thực REST API. Giữ bí mật sessionToken; token này có thể dùng để tiếp tục phiên hiện có.

Thử lại và hết hạn

Mã sai trả lỗi và không cấp JWT. Bạn có thể thử xác minh lại khi yêu cầu xác thực còn hiệu lực. Nếu API trả HTTP 410, đăng nhập lại để nhận yêu cầu xác thực và cookie mới. Không dùng lại mã dự phòng đã tiêu thụ hoặc tự tạo cookie xác thực.

Nội dung

application/json

Email identifier and password credentials.

Password login request. Set identifier to the account email address.

identifier

string

bắt buộc

Email address associated with the Vero OMS account.

Minimum string length: 1

password

string

bắt buộc

Current password for the Vero OMS account.

Minimum string length: 1

Phản hồi

Phiên đã xác thực kèm JWT, hoặc yêu cầu xác thực yếu tố thứ hai đang chờ. Kiểm tra status.

Option 1
Option 2

Kiểm tra status trong mọi phản hồi HTTP thành công. authenticated chứa JWT; mfa_required yêu cầu gọi POST /api/auth/mfa/verify với cookie từ phản hồi.

status

enum<string>

bắt buộc

Cho biết xác thực đã hoàn tất và JWT có thể được sử dụng.

Tùy chọn có sẵn:

authenticated

sessionToken

string

bắt buộc

Token phiên tài khoản. Giữ bí mật token này. Dùng để tiếp tục phiên; dùng jwt để xác thực REST API.

jwt

string

bắt buộc

Bearer JWT cho yêu cầu REST API cần xác thực. Gửi bằng Authorization: Bearer .

session

object

bắt buộc

Phiên đã xác thực và đang hoạt động.

Hide child attributes

session.id

string

Unique identifier for the record.

session.active

boolean

Indicates whether the session is active.

session.authenticated_at

string<date-time>

Timestamp when the session was authenticated.

session.expires_at

string<date-time>

Timestamp when the session expires.

session.devices

object[]

Devices associated with the authenticated session.

Hide child attributes

session.devices.ip_address

string

IP address reported for the session device.

session.devices.location

string

Location metadata reported for the session device.

session.devices.user_agent

string

User agent reported for the session device.

session.identity

object | null

Thông tin danh tính tài khoản của phiên đã xác thực, hoặc null nếu phản hồi không có danh tính.

Hide child attributes

session.identity.id

string

Unique identifier for the record.

session.identity.traits

object

Account attributes returned with the authenticated session.

session.tokenized

string

Bearer JWT issued for REST API calls.

session.authenticator_assurance_level

enum<string>

Mức xác thực của phiên: aal1 sau khi xác thực yếu tố thứ nhất; aal2 sau khi xác thực hai lớp thành công.

Tùy chọn có sẵn:

aal1,

aal2

identity

object | null

bắt buộc

Danh tính tài khoản, hoặc null nếu không có.

Hide child attributes

identity.id

string

Unique identifier for the record.

identity.traits

object

Account attributes returned with the authenticated session.

tokenizedSession

object

bắt buộc

Phiên đã xác thực chứa JWT trong trường tokenized.

Hide child attributes

tokenizedSession.id

string

Unique identifier for the record.

tokenizedSession.active

boolean

Indicates whether the session is active.

tokenizedSession.authenticated_at

string<date-time>

Timestamp when the session was authenticated.

tokenizedSession.expires_at

string<date-time>

Timestamp when the session expires.

tokenizedSession.devices

object[]

Devices associated with the authenticated session.

Hide child attributes

tokenizedSession.devices.ip_address

string

IP address reported for the session device.

tokenizedSession.devices.location

string

Location metadata reported for the session device.

tokenizedSession.devices.user_agent

string

User agent reported for the session device.

tokenizedSession.identity

object | null

Thông tin danh tính tài khoản của phiên đã xác thực, hoặc null nếu phản hồi không có danh tính.

Hide child attributes

tokenizedSession.identity.id

string

Unique identifier for the record.

tokenizedSession.identity.traits

object

Account attributes returned with the authenticated session.

tokenizedSession.tokenized

string

Bearer JWT issued for REST API calls.

tokenizedSession.authenticator_assurance_level

enum<string>

Mức xác thực của phiên: aal1 sau khi xác thực yếu tố thứ nhất; aal2 sau khi xác thực hai lớp thành công.

Tùy chọn có sẵn:

aal1,

aal2

Đăng nhập bằng mật khẩu

curl --request POST \
  --url https://platform.verolabs.co/api/auth/login \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifier": "<string>",
  "password": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({identifier: '<string>', password: '<string>'})
};

fetch('https://platform.verolabs.co/api/auth/login', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://platform.verolabs.co/api/auth/login"

payload = {
    "identifier": "<string>",
    "password": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.verolabs.co/api/auth/login"

	payload := strings.NewReader("{\n  \"identifier\": \"<string>\",\n  \"password\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

using RestSharp;


var options = new RestClientOptions("https://platform.verolabs.co/api/auth/login");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddJsonBody("{\n  \"identifier\": \"<string>\",\n  \"password\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://platform.verolabs.co/api/auth/login");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"identifier\": \"<string>\",\n  \"password\": \"<string>\"\n}");

CURLcode ret = curl_easy_perform(hnd);

{
  "status": "authenticated",
  "sessionToken": "<session-token>",
  "jwt": "<jwt>",
  "session": {
    "active": true,
    "authenticator_assurance_level": "aal1",
    "tokenized": "<jwt>"
  },
  "identity": null,
  "tokenizedSession": {
    "active": true,
    "authenticator_assurance_level": "aal1",
    "tokenized": "<jwt>"
  }
}

Tổng quan

Integrations

Authentication

REST API

Streaming API

FIX API

Đăng nhập và lấy JWT

Trạng thái phản hồi

Đăng nhập bằng cURL

1. Gửi email và mật khẩu

2. Xác minh yếu tố thứ hai khi được yêu cầu

3. Gọi REST API bằng JWT

Thử lại và hết hạn

Nội dung

Phản hồi

​Trạng thái phản hồi

​Đăng nhập bằng cURL

​1. Gửi email và mật khẩu

​2. Xác minh yếu tố thứ hai khi được yêu cầu

​3. Gọi REST API bằng JWT

​Thử lại và hết hạn

Nội dung

Phản hồi

Trạng thái phản hồi

Đăng nhập bằng cURL

1. Gửi email và mật khẩu

2. Xác minh yếu tố thứ hai khi được yêu cầu

3. Gọi REST API bằng JWT

Thử lại và hết hạn