接口使用注意事项,必看
## 接入接口说明,必看
>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:{...}}
```