服务端开放能力:接口清单与错误码
开放接口清单(余额、起司、学生认证、用户详情、平台信息)与业务错误码表。
更新于 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 | 应用等级不足 | 联系通行证管理员提升应用等级 |