Bắt đầu nhanh

Tài khoản đối tác

Đăng ký ⇒ có Developer workspace với dữ liệu mẫu, không hết hạn. Đã có tài khoản NextX: tạo thêm Developer workspace.

Tạo app

Ứng dụng của tôi → Tạo app → chọn Use cases → nhận App ID + App Secret ngay (Development mode). App Secret chỉ hiện một lần — cất vào kho secret.

Cài app vào Developer workspace

Trong app: Workspace đã cài → Cài vào workspace của bạn. Development mode cài được tối đa 3 workspace của chính bạn; Publish rồi mọi khách mới cài được. Chưa cài ⇒ lấy token bị 403 oauth2.app_not_installed.

Lấy Access token

curl -X POST https://api.nextx.vn/api/v1/iam/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=<APP_ID>" \
  -d "client_secret=<APP_SECRET>" \
  -d "workspace_id=<WORKSPACE_ID>"
# → { "access_token": "...", "expires_in": 3600, ... }

Hoặc bấm Generate Access Token ở Test Console. Access token sống 1 giờ; hết hạn thì gọi lại bước này.

Gọi API đầu tiên

curl "https://api.nextx.vn/api/v1/crm/contacts?pageSize=5" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Thiếu scope → 403; vượt Rate limit → 429. Xem bảng error code.