八戒财税 | 开放平台

调用方式

通信协议

八戒财税开放平台所有接口均通过 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 服务器内部错误 系统错误，请联系技术支持

接口鉴权 →