{{apiInfo.name}}
{{apiInfo.describe}}
本文档介绍单独访问地址:http://wx.xwykj.com/openapi/doc?docid={{apiInfo.id}}
开放平台接口 开发说明:
开发步骤:1、提供白名单ip地址。
2、我们平台创建开放平台账号,由我方工作人员提供平台开发所需的appid、appsecret。
3、通过appid和appsecret获取接口访问token。
4、开发相关业务接口,根据不同的接口文档的要求提供所需的业务参数以外,还要携带 appid 、 token 、timeStamp 以及sign。
请点击左侧接口分组列表获取你要对接开发的相关接口。如有相关疑问可以联系商务经理拉群,提供技术支持。
baseUrl 请求地址:http://wx.xwykj.com/openapi/
appid和appsecret由本平台提供。使用appid和appsecret获取访问的token。后面请求所有接口均要携带此访问token。其中token有效期为7200秒,有效期内重复获取返回相同结果。过期后可重新请求获取新的token。
为了提高账户安全性,所有的接口访问均需要白名单控制,需要将你的请求服务器IP地址提供给我们销售经理,设置到白名单中才可正常访问接口。
公共返回的参数有三项,status、info、data。 其中:status 【1】代表返回成功 【0】代表失败。 info :为返回的文字说明(正确、错误均有说明) data: 为返回的值。如果为错误则通常不返回data。
获取token的接口只要appid和appsecret即可,其他的接口除了传递业务参数以外,还需要带上appid、token、sign、timeStamp 这四个公共的参数,一起post到接口上。
sign签名规则如下: 所有需要请求的值 转json字符串 再md5 然后和 appid 、 token 、timeStamp 一起拼接成字符串 最后再md5 组成签名。 举例说明:md5(md5(json_encode(param))+appid+token+timeStamp),其中param为需要请求的业务参数,将业务参数转成json字符串,进行md5,然后与appid、token、时间戳timeStamp拼接起来,组成新的字符串,最后再md5,生成签名。
注意:appid 、 token 、timeStamp 以及sign 不需要参与转json运算。
时间戳为秒数,请求的时间与北京时间相差不要超过5分钟。 时间戳为格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数。
接口请求地址:
POST
baseUrl+ {{apiInfo.api_url}}
请求参数:
{{item.name}}
|
{{item.field_name}} |
{{item.is_require == 1? '是':'否'}} |
{{item.field_describe}} |
page |
否 |
分页参数,当前请求第几页的数据,默认显示第一页 |
perpage |
否 |
分页参数,每页显示多少条记录,默认显示10条 |