前期准备
- “开发者后台>密钥管理”模块申请密钥
- 审核通过后会获取到AppId和AppSecret
接入流程
- 使用AppId和AppSecret等参数，通过获取access token API换取access token
- 使用access token等参数，通过业务接口获取业务数据
统一域名地址
https://qfopenapi.qiaofangyun.com
统一响应参数
| 参数名 | 描述 | 数据类型 | 必填 |
|---|---|---|---|
| responseCode | 响应码, 1表示成功 | String | 是 |
| responseMessage | 响应消息 | String | 是 |
| responseType | 响应类型 | String | 否 |
| data | 返回具体数据 | Object | 否 |
响应示例：
{
"responseCode": "1",
"responseMessage": "success",
"responseType": null,
"data": {
"accessToken": "42d44a63b692502e89f099002ba93aa2",
"expiresIn": "7200"
}
}
全局返回码
| 返回码 | 返回消息 |
|---|---|
| openverify000 | header参数 X-TIME-STAMP 无效 |
| openverify001 | header参数 X-AUTH-OPENPLATFORM-TOKEN 无效 |
| openverify002 | header参数 X-AUTH-OPENPLATFORM-APP-ID 无效 |
| openverify003 | header丢失 X-TIME-STAMP参数 |
| openverify004 | header丢失 X-AUTH-SIGN参数 |
| openverify005 | header参数 X-AUTH-OPENPLATFORM-TOKEN和X-AUTH-OPENPLATFORM-APP-ID不能同时为空 |
| openverify006 | header丢失 X-Device-Id 参数 |
| openverify007 | header丢失 X-App-Version 参数 |
| openverify008 | header丢失 X-Client 参数 |
| openverify009 | header丢失 User-Agent 参数 |
| openverify010 | 请求太频繁，请稍后重试 |
| openverify011 | 签名错误 |
| openverify012 | 非法请求，请使用token访问 |
| openverify101 | appId invaild |
| openverify102 | appId expired |
| openverify103 | token invaild |
| openverify104 | token request limit |
| commonerror001 | 参数错误 |
| commonerror002 | 系统异常 |