API vai trò

Vai trò thuộc công ty của Admin và nhận Package đã được Super Admin cấp cho công ty đó.

Endpoint

Method	Path	Scope	Chức năng
GET	/api/v1/roles	platform.employee.read	Danh sách vai trò.
POST	/api/v1/roles	platform.employee.manage	Tạo vai trò.
GET	/api/v1/roles/{roleId}	platform.employee.read	Chi tiết vai trò.
PUT	/api/v1/roles/{roleId}/packages	platform.employee.manage	Thay toàn bộ Package của vai trò.
PUT	/api/v1/roles/{roleId}/employees	platform.employee.manage	Thay toàn bộ nhân viên của vai trò.

curl --fail-with-body \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  "$NEXUS_URL/api/v1/roles"

Tạo vai trò

curl --fail-with-body -X POST \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"display_name":"Nhân viên kinh doanh","packages":["sales.employee.tools"]}' \
  "$NEXUS_URL/api/v1/roles"

Nexus tự sinh roleId. Lấy ID từ response để dùng cho request sau.

Thay Package hoặc nhân viên

export ROLE_ID="business.example"

curl --fail-with-body -X PUT \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"packages":["sales.employee.tools"]}' \
  "$NEXUS_URL/api/v1/roles/$ROLE_ID/packages"

curl --fail-with-body -X PUT \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d "{\"employees\":[\"$EMPLOYEE_ID\"]}" \
  "$NEXUS_URL/api/v1/roles/$ROLE_ID/employees"

Hai endpoint PUT đều thay toàn bộ danh sách hiện tại, không cộng thêm từng item.