重庆互联网,19年企业互联网解决经验,专业网站开发、移动端开发、微信端开发、小程序开发!
重庆网络推广公司

腾讯小微(67)— 小微开放接口(10)

作者:重庆互联网小徐 发布时间:2024-07-29 浏览:20086 赞(1950 收藏 评论(0)

公共参数

域名

wss://xwcloudapi.weixin.qq.com/

请求参数

请求参数遵循xwschema协议中定义的websocket_req

字段名类型含义
cmdint固定为0
productint固定为6201
seqint固定填0
http.methodstring固定都是使用post
http.pathstring调用接口路径,参见:接口说明
http.querystring保持为空即可
http.header.Hoststring固定使用xwcloudapi.weixin.qq.com
http.header.Ticketstring票据信息,通过/xwopenapi/authdevice接口获取
http.header.RequestIDstring请求ID,每个请求唯一
contentstring接口请求内容进行base64encode后的结果,下文有详细说明
注:Ticket除调用/xwopenapi/authdevice接口填空,其余所有接口必填

content字段格式说明

content内容与接口类型相关,但加密方式一样:都是先将接口内容JSON序列化成字符串,再base64加密。 js代码表示为:

window.btoa(JSON.stringify({{接口内容JSON对象}}));

golang代码表示为:

content, _ := json.Marshal({{接口内容对象}})
sendContent := base64.StdEncoding.EncodeToString(content)

返回结果格式

返回参数遵循xwschema协议中定义的websocket_rsp

字段名类型含义
cmdint为0 代表为同步返回,为其他代表异步返回
seqint固定为0
http.statusCodeinthttp状态码
http.headerobjecthttp header头部信息
encodingstring编码类型
scenestring后台推送时为notify,同步返回为空
contentstringbase64编码后的返回内容

返回content字段解析步骤

  1. 对content字段使用base64解码

  2. 再对上一步得到的字符串进行json反序列化,得到json对象,结构如下:

{
  "request_id":"", // 对应请求的request_id
  "type":1, // 参见下文介绍
  "response":""
}
  1. 上一步得到的response字段内容为各个业务接口实际返回的内容经过JSON序列化后的结果,对其进行JSON反序列化可得到业务返回的实际内容。

content.type字段说明

type说明
1代表notify结果,需要根据返回的cmd字段解析
2同步返回的结果,code=0 代表请求成功,不为0表示该请求出错,不会收到异步结果推送
3auth结果,专门针对/xwopenapi/authdevice接口返回的结果,返回code=0表示auth成功,否则失败

重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案,专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发,帮助企业实现从传统行业到互联网的完美转型。截止目前,重庆互联网合作的企业遍布全国各地,20年的开发经验和完善的售后服务体系获得合作客户的高度认可!

关注重庆互联网官方公众号,即可获取粉丝专享福利!

重庆互联网公众号二维码.jpg

网友留言评论
我要评论
评论

欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!

  • 赞(0
    踩(0
重庆网站定制建设
  • 重庆网站建设平台
  • 重庆网站优化公司
  • 重庆网络推广公司哪家好
  • 重庆APP制作公司
版权所有 ©2004-2024 重庆市渝中区圣灵科技信息有限公司 渝ICP备16004600号-14 渝公网安备50010802001420号 电子营业执照
重庆公众号制作哪家好
二维码
联系客服 重庆商城网站建设