Skip to content

API 参考 ​

CAMP 后端接口(网关口径,基于 release-2606.v2.2.x 的 proto 生成),按业务域组织:

网关地址 ​

服务前缀
auc{网关地址}/camp/api/org
nova{网关地址}/camp/api/nova

各接口文档中的路径(如 /v1/user/login-public-key)为拼在前缀后的后端路径(登录接口例外,走 BFF 路由,见下方鉴权说明)。

鉴权 ​

除少数真正免登录的接口(接口列表里「鉴权」列标为「公开」的那些,auc 只有 7 个、nova 为 0 个)外, 所有接口请求头必须携带登录后拿到的 token:

x-token: <token>

网关只认 x-token,不认 Authorization: Bearer。登录密码需 RSA-OAEP-256 加密 (先 GET /v1/user/login-public-key 取公钥),完整流程与代码示例见交互页内各登录接口说明。

⚠️ 带对 x-token 不等于一定能调通:网关鉴权之后还会做「资源/菜单权限位」授权,账号对该资源 没有权限位时同样返回 500015(仅 super_admin 免检)。对接账号需具备目标接口的资源权限。

⚠️ 登录接口的对外路径与公钥不同:公钥走 GET /camp/api/org/v1/user/login-public-key; 登录走 BFF 路由 POST /camp/bff/org/user/login,响应为 BFF 信封 {code,data},x-token 取 data.token.token。 若按 proto 路径打 POST /camp/api/org/v1/user/login,会被资源鉴权拦截(500015)。

请求 / 响应约定 ​

  • Content-Type: application/json;POST/PUT 字段放 body,GET/DELETE 字段拼 query。
  • 成功:HTTP 200,直接返回数据结构。失败:HTTP 状态码即业务 code (如 521),响应体为 {"code": 521, "reason": "INVALID_ARGUMENT", "message": "...", "metadata": {}}。
  • int64 字段经 protojson 序列化后为字符串,使用前请转换。

基于 Rise 智算平台 release-2606.v2.2.x 生成