ThinkWheel Docs
接入指南

能力配置与分组

运营后台管理能力,开发者通过接口查询与关联。

运营管理

独立运营后台提供分组新增/编辑、能力新增/编辑及启停。管理员需在服务端 ADMIN_EMAILS 白名单中,通过邮箱验证码登录后操作。普通开发者登录不具备管理权限。

能力配置包括稳定的能力标识、名称、分组、说明、排序、状态、上游基础 URL、上游密钥、上游模型和默认请求路径。上游密钥加密入库,新增必填,编辑留空保留原值。列表与详情不返回密钥,调用时校验应用权限后解密使用。

开发者查询

以下接口使用控制台 JWT(Authorization Bearer)鉴权:

  • GET /api/capabilities:可用能力列表,包含分组标识。
  • GET /api/capabilities/groups:分组名称和排序。
  • GET /api/capabilities/:id:能力详情,不返回上游地址及密钥配置。

后台新增能力后,刷新控制台或 Demo 即可获取。应用创建/编辑时从该列表选择需要的能力;也可在能力卡片上关联已有应用。

调用与状态

接口调用仍以 Authorization: Bearer <Access Key> 请求头验证应用,通过查询参数 model 选择能力。能力停用后从可用列表移除,已关联应用也无法继续调用;历史关联不会被删除。标识不可修改,当前不提供能力删除。

上游模型和默认请求路径用于 Demo 构造请求;通用网关保持调用方 JSON 原样转发,不自动重写业务模型。详见 统一调用接口。

On this page