Gọi API thay khách (resource gateway)

Dùng access_token của HiTechCloud ID để gọi API thay mặt người dùng qua resource gateway https://iam.hitechcloud.vn/api/v1/gw/<route>, giới hạn bằng scope.

Xem Markdown
Resource gateway đang được hoàn thiện. Danh mục scope và các route có thể thay đổi — hãy đối chiếu lại với bản triển khai cuối.

Sau khi có access_token, ứng dụng của bạn gọi API thay mặt khách qua resource gateway. Gateway kiểm tra token, đối chiếu scope rồi chuyển tiếp tới các route User API tương ứng.

Gọi gateway

Đặt access_token vào header Bearer và gọi tới https://iam.hitechcloud.vn/api/v1/gw/<route>.

cURL
curl 'https://iam.hitechcloud.vn/api/v1/gw/profile' \
  -H 'Authorization: Bearer at_opaque_xxx'

Danh mục scope

Mỗi route yêu cầu một scope nhất định; token phải được cấp scope đó (ở bước authorize) thì gateway mới cho qua.

ScopeCho phép
openidBắt buộc cho OIDC; mở UserInfo
profileĐọc họ tên, hồ sơ cơ bản
emailĐọc địa chỉ email
offline_accessNhận refresh_token để gọi lâu dài
profile:read / profile:writeĐọc / cập nhật hồ sơ khách
services:read / services:writeĐọc / thao tác dịch vụ đã đăng ký
domains:read / domains:writeĐọc / quản lý tên miền
dns:read / dns:writeĐọc / sửa bản ghi DNS
billing:read / billing:writeĐọc / thao tác hoá đơn, thanh toán
orders:writeTạo đơn hàng / đặt dịch vụ
tickets:read / tickets:writeĐọc / tạo & trả lời ticket hỗ trợ
Xin tối thiểu scope cần dùng. Khách thấy đúng những quyền này trên trang đồng ý; xin thừa làm giảm tỉ lệ đồng ý và tăng rủi ro.

Lỗi uỷ quyền

LỗiHTTPXử lý
invalid_token401Token sai/hết hạn/đã thu hồi — làm mới hoặc đăng nhập lại.
insufficient_scope403Token thiếu scope cho route này — xin thêm scope rồi cấp lại token.

Các lỗi này trả kèm header WWW-Authenticate mô tả error và scope còn thiếu, theo RFC 6750.