查询余额
GET
/api/open/v1/balance查询机构预存信用点余额。返回当前余额(提交任务前可据此判断额度是否充足)。
请求头
以下签名头对所有开放 API 通用,缺失或不合法将验签失败。
| 名称 | 说明 |
|---|---|
X-App-Id | 应用标识,平台为机构分配的 App ID。 |
X-Timestamp | 毫秒级时间戳;与服务器时间偏差须在 ±300 秒内。 |
X-Nonce | 一次性随机串,10 分钟内不可重复,用于防重放。 |
X-Signature | 对待签内容做 HMAC-SHA256(密钥为 appSecret)后的 Base64 签名值。 |
响应示例
响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
balance | number | 机构当前预存信用点余额。 |
可能的错误码
| 错误码 | 说明 |
|---|---|
1401 | 参数缺失或不合法 |
1429 | 请求过于频繁(负载限流,HTTP 429) |
1449 | 系统繁忙,请稍后再试 |
2001 | 验签失败 |
2002 | 时间戳超窗 |
2003 | 重复请求 |
2004 | 应用不存在或已停用 |
2005 | 来源IP未授权 |