Entitlement Service REST 接口

Entitlement Service 的 REST 接口用于处理写入操作，如分配更新和批量导入。以读取为主的页面（产品列表、权益汇总、活动日志等）推荐使用 GraphQL 接口。

本地端点

端点	方法	说明
/healthz	GET	健康检查
/organizations/{organizationId}/products/{productId}/allocations	PUT	更新产品的手动席位分配
/organizations/{organizationId}/bulk-import-jobs	POST/GET	创建和查询批量导入任务
/bulk-import-jobs/{jobId}/artifacts.zip	GET	下载导入产物（结果、错误报告）
/graphql	POST	GraphQL 端点（参见 GraphQL 接口文档）

基础地址：http://127.0.0.1:4317

分配更新示例

await fetch(
  'http://127.0.0.1:4317/organizations/org-demo-001/products/prod-insight-studio/allocations',
  {
    method: 'PUT',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      selectedUserIds: ['user-tenant-admin', 'user-tenant-member'],
    }),
  }
);

该请求会替换该产品当前的手动分配（而非追加）。selectedUserIds 应使用 GraphQL 查询 productUserAccess 返回的 ID。更新成功后，需要刷新权益汇总、已分配用户列表和活动日志。

完整 API 参考

• Redoc 参考页 —— 静态生成的参考文档