调用方式
通信协议
八戒财税开放平台所有接口均通过 HTTPS 进行通信，提供高安全性的通信通道。
接口统一域名：https://open.cs.zbj.com
请求方法
支持的 HTTP 请求方法: POST（推荐）、GET
TIP
推荐使用 POST 请求，两者的结果并无差异，但 GET 请求只支持 32 KB 以内的请求包。
POST 请求支持的 Content-Type 类型：
- application/json（推荐）
- application/x-www-form-urlencoded
字符编码
均使用UTF-8编码。
返回结果
成功响应格式, HTTP Status: 200
{
"success": true,
"code": 0,
"data": {},
"requestId": "唯一请求id",
}
错误响应格式, HTTP Status: 400
{
"success": false,
"code": 405,
"message": "拒绝访问",
"description": "接口受限，请联系销售顾问",
"requestId": "唯一请求id",
}
公共错误码
| 错误码 | 提示信息 | 描述 |
|---|---|---|
| 400 | 鉴权失败 | 检查签名 |
| 401 | 重放攻击 | 检查时间戳和Nonce参数 |
| 402 | 鉴权参数不全 | 公共参数缺失 |
| 403 | 请求不支持 | 仅支持GET、POST请求 |
| 404 | NonceID过长 | 36个以内字符 |
| 405 | 拒绝访问 | 授权认证未通过,请检查传参是否正确 |
| 406 | 超过配额 | 应用资源已消耗完或被停用，请联系销售顾问 |
| 500 | 服务器内部错误 | 系统错误，请联系技术支持 |