接口使用注意事项,必看

## 接入接口说明,必看 >d + 首先我们这边接口会提供一个接口请求地址**requireUrl**,所有的接口都是通过这个接口地址进行http请求; > + 然后调用方给定一个固定的网址**callbackUrl**,我们会把返回结果通过http异步调用这个网址返回给调用方,**callbackUrl**可以通过**接口回地址设置**这个接口进行设置 > + 也支持接收websocket回调信息,通过websocket接收异步返回的结果,websocket端口为ws://ip:90000 ## 1.请求格式 调用地址requireUrl,请求方式是POST,提交请求数据是用body方式 格式如下 `cmd:请求命令` `data:请求数据` ```language { "cmd":"getQrcode", "data":{ ... } } ``` ## 2.http响应结果同步返回格式 `code:返回结果状态码` `msg:返回信息` `data:返回数据` ```language { "code":200, "msg":"", data:{ ... } } ``` ## 3.http的code状态码说明 |状态码|说明| |-|-|-| |200|正常相应| |400|异常返回| |401|微信号掉线| ## 4.接口回调地址设置 可以通过该接口设置所有接口异步返回的回调地址,callbackUrl为接口回调地址 ``` { "cmd": "callbackUrlSet", "data": { "callbackUrl": "http://www.baidu.com" } } ``` ## 5.异步结果返回 调用callbackUrl网址,请求方式是POST,提交请求数据是用body方式 ```language `respCode:异步返回数据类型` `data:异步返回数据` {"respCode":"getQrcode",data:{...}} ```