作者:重庆互联网小徐 发布时间:2024-07-29 浏览:20520 赞(1950) 收藏 评论(0)
wss://xwcloudapi.weixin.qq.com/
请求参数遵循xwschema协议中定义的websocket_req
字段名 | 类型 | 含义 |
---|---|---|
cmd | int | 固定为0 |
product | int | 固定为6201 |
seq | int | 固定填0 |
http.method | string | 固定都是使用post |
http.path | string | 调用接口路径,参见:接口说明 |
http.query | string | 保持为空即可 |
http.header.Host | string | 固定使用xwcloudapi.weixin.qq.com |
http.header.Ticket | string | 票据信息,通过/xwopenapi/authdevice 接口获取 |
http.header.RequestID | string | 请求ID,每个请求唯一 |
content | string | 接口请求内容进行base64encode后的结果,下文有详细说明 |
注:Ticket 除调用/xwopenapi/authdevice 接口填空,其余所有接口必填 |
content内容与接口类型相关,但加密方式一样:都是先将接口内容JSON序列化成字符串,再base64加密。 js代码表示为:
window.btoa(JSON.stringify({{接口内容JSON对象}}));
golang代码表示为:
content, _ := json.Marshal({{接口内容对象}}) sendContent := base64.StdEncoding.EncodeToString(content)
返回参数遵循xwschema协议中定义的websocket_rsp
字段名 | 类型 | 含义 |
---|---|---|
cmd | int | 为0 代表为同步返回,为其他代表异步返回 |
seq | int | 固定为0 |
http.statusCode | int | http状态码 |
http.header | object | http header头部信息 |
encoding | string | 编码类型 |
scene | string | 后台推送时为notify ,同步返回为空 |
content | string | base64编码后的返回内容 |
对content字段使用base64解码
再对上一步得到的字符串进行json反序列化,得到json对象,结构如下:
{ "request_id":"", // 对应请求的request_id "type":1, // 参见下文介绍 "response":"" }
上一步得到的response
字段内容为各个业务接口实际返回的内容经过JSON序列化后的结果,对其进行JSON反序列化可得到业务返回的实际内容。
type | 说明 |
---|---|
1 | 代表notify结果,需要根据返回的cmd字段解析 |
2 | 同步返回的结果,code=0 代表请求成功,不为0表示该请求出错,不会收到异步结果推送 |
3 | auth结果,专门针对/xwopenapi/authdevice 接口返回的结果,返回code=0表示auth成功,否则失败 |
重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案,专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发,帮助企业实现从传统行业到互联网的完美转型。截止目前,重庆互联网合作的企业遍布全国各地,20年的开发经验和完善的售后服务体系获得合作客户的高度认可!
关注重庆互联网官方公众号,即可获取粉丝专享福利!
欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!