服务端开放能力:接口清单与错误码

开放接口清单(余额、起司、学生认证、用户详情、平台信息)与业务错误码表。

更新于 2026-10-10

服务端开放能力:接口清单与错误码

本文列服务端开放接口的完整清单、请求响应要点与业务错误码。签名方式见《签名规范》。

一、接口清单

接口 说明
GET /open/v1/internal/balance?user_id= 查用户余额
POST /open/v1/internal/balance/adjust 调整余额,body:{user_id, amount, reason}
GET /open/v1/internal/student/status?user_id= 学生认证状态(approved = 可购学生商品)
GET /open/v1/internal/users/{id} 用户完整详情
POST /open/v1/internal/cheese/adjust 调整起司
GET /open/v1/meta 平台公开信息(会员等级表 / 起司兑换比例)

完整目录以 https://account.cheesesynx.cn/dev-docs.html 为准。

二、要点

  • 金额单位一律为「分」(整数):正数入账、负数扣减;
  • 扣余额前建议先查余额;余额不足返回 6321(正常业务错误,不要当系统异常重试);
  • reason 必填,会进入通行证审计与用户账单流水。

三、错误码速查

错误码 含义 处理
6106 签名不符 核对签名六段顺序、body 原始字节、query 原样拼接(见《签名规范》)
6321 用户余额不足 正常业务错误,提示用户充值
401 鉴权头缺失 / App Key 无效 核对四个 X-Ext-* 头
403 应用等级不足 联系通行证管理员提升应用等级