API 参考
CAMP 后端接口(网关口径,基于 release-2606.v2.2.x 的 proto 生成),按业务域组织:
- 场景化操作指引:按“我要做什么”找接口(对接入门、开通算力、上线推理、训练任务、费用对账)
- 在线调试(Scalar):单入口,含全部 788 个接口,可直接发请求
- AUC 接口列表 / Nova 接口列表:按网关分的完整清单
网关地址
| 服务 | 前缀 |
|---|---|
| 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 序列化后为字符串,使用前请转换。