全国发票真伪查询API_发票验证API_API数据开放平台-八戒财税

开放平台V1 文档中心应用中心

获取token

使用方法

使用OAuth2 的客户端凭证授权模式（Client Credentials Grant）获取token，OAuth2协议规范文档参考：

● Client Credentials

● Client Credentials Grant

调用地址: https://open.cs.zbj.com/oauth/token

请求方式: POST

返回类型: JSON

调试工具: 去调试

请求参数Body

名称	类型	是否必须	描述
grant_type	STRING	必须	目前只能为client_credentials
client_id	STRING	必须	您申请应用获得的appKey(查看)
client_secret	STRING	必须	您申请应用获得的appSecret(查看)
scope	STRING	可选	权限范围

请求参数示例

POST /oauth/token HTTP/1.1
Host: open.cs.zbj.com
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=xxxxxxxxxx
&client_secret=xxxxxxxxxx

成功响应参数说明

名称	类型	是否必须	描述
access_token	STRING	必须	访问令牌
token_type	STRING	必须	访问令牌类型，始终为Bearer

成功响应参数示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
"access_token":"2YotnFZFEjr1zCsicMWpAA",
"token_type":"Bearer"
}

错误响应参数示例

HTTP状态码	错误信息	描述
400	Bad Request	Authorization格式错误
403	AppKey or appSecret is incorrect	应用的appkey或appSecret不正确、应用被停用
403	The app is not enabled or the number of interface calls has been exhausted	应用充值点已消耗完
501	Unsupported grant type	grant_type错误
500	server_error	未知系统错误，请反馈给技术支持

错误响应示例

响应body，success均为false

HTTP/1.1 403 Forbidden
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
    "success": false,
    "data":"AppKey or appSecret is incorrect"
}