Ứng dụng & OAuth

Chọn cách xác thực

API key →

Lấy access token (client credentials)

Sau khi workspace cài app, máy chủ của bạn đổi client_id + client_secret lấy token cho từng workspace.

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=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "workspace_id=WORKSPACE_GUID" \
  -d "scope=crm.contacts.view sales.orders.view"

Phản hồi:

{
  "access_token": "eyJhbGciOiJSUzI1Ni...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "crm.contacts.view sales.orders.view"
}

• scope thực cấp = requested ∩ allowed (của app) ∩ granted (workspace consent).
• Phản hồi có trường refresh_token nhưng luôn rỗng — không dùng để gia hạn. Token hết hạn thì gọi lại endpoint này.
• workspace_id = GUID của workspace đã cài app (mỗi workspace 1 token riêng).

Link cài và đồng ý cấp quyền

Workspace cài app qua link cài; màn đồng ý liệt kê đúng các scope app xin. Thử ngay trên workspace của bạn ở Development mode, rồi Publish để khách khác cài được.

Scope (quyền)

Scope = mã quyền dạng service.resource.verb, verb là view (đọc) hoặc manage (ghi). App chỉ xin được scope, workspace mới là bên đồng ý cấp.