微信协议 SAAS
企微接口
企微接口
  1. Sns
  • 文档说明
  • 更新日志
  • 客户端
    • 恢复实例
      POST
    • 停止实例
      POST
    • 设置实例通知地址
      POST
    • 设置实例桥接ID
      POST
    • 设置实例代理
      POST
    • 升级实例
      POST
    • 获取实例状态
      POST
    • 获取实例版本
      POST
  • Login
    • 获取登录二维码
      POST
    • 检查登录二维码状态
      POST
    • 推送手机确认登录通知
      POST
    • 验证登录
      POST
  • User
    • 获取登录账号信息
      POST
    • 获取个人二维码
      POST
    • 退出登录
      POST
  • Contact
    • 同步联系人
    • 同步联系人
      POST
    • 置顶聊天
      POST
    • 获取联系人详细
      POST
    • 批量获取联系人简要信息
      POST
    • 通过手机号,微信号或QQ搜素微信用户
      POST
    • 添加微信用户
      POST
    • 检查好友状态、单向加好友和同意好友申请
      POST
    • 修改好友备注
      POST
    • 删除好友
      POST
  • Room
    • 获取群列表 (本地存储)
    • 获取群列表(本地存储 当前微信是群主或者管理员)
    • 获取群成员 (本地存储)
    • 获取群信息
    • 获取群成员详细
    • 创建群组
    • 添加群成员(低于40人)
    • 邀请群成员
    • 移除群成员
    • 修改群名称
    • 设置群公告
    • 修改群显示昵称
    • 是否显示群成员昵称
    • 是否保存到通讯录
    • 是否折叠群
    • 消息免打扰
    • 添加群成员为好友
    • 退出群
    • 转让群主
    • 置顶消息
    • 取消置顶消息
    • 获取置顶消息列表
    • 获取群二维码
    • 置顶聊天
  • Msg
    • 接收消息
    • 发送文本消息
    • 发送群@消息
    • 发送分享名片
    • 发送分享名片
    • 发送位置
    • 发送图片
    • 发送视频
    • 发送文件
    • 发送表情
    • 发送表情url
    • 发送表情md5
    • 发送拍一拍
    • 发送链接卡片
    • 发送链接卡片CDN
    • 发送APPMSG
    • 发送小程序
    • 发送视频号
    • 撤回消息
    • 发送引用消息
    • 设置消息已读
    • 生成语音转文字ID
    • 检查语音转文字
    • 上传待转文字的语音
    • 获取语音转文字结果
  • Cloud
    • 更新CDNClient DNS信息
    • 上传图片、视频或文件
    • 上传朋友圈类型图片
    • 上传朋友圈类型视频
    • 下载图片、视频或文件
    • 下载收藏类型的文件或视频
    • 下载企微媒体文件
    • 下载语音
    • 下载微信加密视频
    • 下载微信加密图片
    • 下载微信加密表情
  • Label
    • 获取所有标签
    • 新建标签
    • 修改标签
    • 删除标签
    • 给联系人打标签
    • 根据标签获取联系人 (本地存储)
    • 根据标签下关联联系人的数量 (本地存储)
  • OpenIM
    • 获取企微好友列表 (本地存储)
    • 获取企微群列表 (本地存储)
    • 获取企微群群成员 (本地存储)
    • 获取企微群信息
    • 获取企微群成员信息
    • 获取企微联系人详细信息
    • 获取企微联系人企业信息
    • 通过企微二维码查询联系人
    • 添加企微联系人
    • 发送企微联系人验证请求
    • 删除企微联系人
    • 检查企微联系人状态接口
    • 修改企微联系人免打扰状态
    • 修改企微联系人置顶状态
  • Sns
    • 获取朋友圈动态
      POST
    • 获取好友朋友圈动态
      POST
    • 发布朋友圈
      POST
    • 获取朋友圈动态详细信息
      POST
    • 评论
      POST
    • 删除评论
      POST
    • 点赞/取消点赞
      POST
    • 删除朋友圈
      POST
  • App
    • 取真实URL
    • 取真实URL
    • 小程序授权登录
    • 小程序安全通讯
    • 小程序安全通讯VIP
    • OAuth登录授权
    • OAuth登录授权确认
    • 第三方网站扫码登录授权
    • 第三方网站扫码登录授权确认
    • 生成小程序短链接
    • 解析小程序短链接
    • 解析小程序短链接
  • Other
    • 语音转文字
    • 语音转文字分片
  1. Sns

发布朋友圈

POST
/sns/sns_post
其他类型朋友圈例子,把 xml base64 后传入 object_desc
username 需要改成当前号的 wxid

视频#

<TimelineObject><id>0</id><username>wxid_5cg2ipa1um8r22</username><createTime>1734776146</createTime><contentDesc>圣诞快乐</contentDesc><contentDescShowType>0</contentDescShowType><contentDescScene>0</contentDescScene><private>0</private><sightFolded>0</sightFolded><showFlag>0</showFlag><appInfo><id></id><version></version><appName></appName><installUrl></installUrl><fromUrl></fromUrl><isForceUpdate>0</isForceUpdate><isHidden>0</isHidden></appInfo><sourceUserName></sourceUserName><sourceNickName></sourceNickName><statisticsData></statisticsData><statExtStr></statExtStr><ContentObject><contentStyle>15</contentStyle><title>微信小视频</title><description>Sight</description><mediaList><media><id>0</id><type>6</type><title></title><description>圣诞快乐</description><private>0</private><userData></userData><subType>0</subType><videoSize width="720" height="1280"/><url type="1" md5="951a7d7864d685a92fd2624155794bf9" videomd5="577f55635faf44f595a69ded26d87bcc">http://szzjwxsns.video.qq.com/102/20202/snsvideodownload?filekey=30340201010420301e0201660402535a04109ad99bd19e723e8858c06584d1d94f0f020367d326040d00000004627466730000000132&amp;hy=SZ&amp;storeid=5676695500005e187117b1cf40000006600004eea535a2b966bc1e7191c7a1&amp;dotrans=9&amp;ef=1_0&amp;ut=U81EFIic1QtHZzChjoSsv73SOGYgZZG8YXDFNEz0RO3kvctX5e9cNSw&amp;ui=1&amp;bizid=1023&amp;ilogo=2&amp;dur=30</url><thumb type="1">http://vweixinthumb.tc.qq.com/150/20250/snsvideodownload?filekey=30340201010420301e020200960402535a0410348e729cac960915ed91291d628a9ab50202701a040d00000004627466730000000132&amp;hy=SZ&amp;storeid=56766955000048dbd117b1cf40000009600004f1a535a2baf0011571964251&amp;bizid=1023</thumb><size width="290.000000" height="516.000000" totalSize="28698"/><videoDuration>30.000000</videoDuration></media></mediaList></ContentObject></TimelineObject>

位置加文本#

<TimelineObject><id>0</id><username>wxid_xxxxxxxxxxxx</username><createTime>1734347356</createTime><contentDesc> 位置 </contentDesc><contentDescShowType>0</contentDescShowType><contentDescScene>3</contentDescScene><private>0</private><sightFolded>0</sightFolded><showFlag>0</showFlag><location city=" 武汉市 " longitude="114.410645" latitude="30.477043" poiName=" 光谷天地 " poiAddress=" 湖北省武汉市洪山区关山大道 519 号 "      poiScale="11.000000" poiInfoUrl="" poiClassifyId="qqmap_288134984679149398" poiClassifyType="1" poiClickableStatus="0" buildingId="420100216539" floorName="" /><appInfo><id></id><version></version><appName></appName><installUrl></installUrl><fromUrl></fromUrl><isForceUpdate>0</isForceUpdate><isHidden>0</isHidden></appInfo><sourceUserName></sourceUserName><sourceNickName></sourceNickName><statisticsData></statisticsData><statExtStr></statExtStr><ContentObject><contentStyle>2</contentStyle><title></title><description></description><mediaList></mediaList></ContentObject></TimelineObject>

位置链接#

<TimelineObject><id>0</id><username>wxid_xxxxxxxxxxxx</username><createTime>1734347542</createTime><contentDesc> 链接 </contentDesc><contentDescShowType>0</contentDescShowType><contentDescScene>4</contentDescScene><private>0</private><sightFolded>0</sightFolded><showFlag>0</showFlag><location city=" 武汉市 " longitude="114.410645" latitude="30.477043" poiName=" 光谷天地 " poiAddress=" 湖北省武汉市洪山区关山大道 519 号 "      poiScale="11.000000" poiInfoUrl="" poiClassifyId="qqmap_288134984679149398" poiClassifyType="1" poiClickableStatus="0" buildingId="420100216539" floorName="" /><appInfo><id></id><version></version><appName></appName><installUrl></installUrl><fromUrl></fromUrl><isForceUpdate>0</isForceUpdate><isHidden>0</isHidden></appInfo><sourceUserName></sourceUserName><sourceNickName></sourceNickName><statisticsData></statisticsData><statExtStr></statExtStr><ContentObject><contentStyle>3</contentStyle><title> 重磅微视频丨续写“一国两制”成功实践崭新篇章 </title><description></description><contentUrl>https://view.inews.qq.com/w/WXN2024121600184400?bat_id=2100313713&amp;refer=nwx&amp;_rp=2&amp;cur_pos=0&amp;ft=0&amp;grp_id=2300313714&amp;newsGid=20241216_r9677793&amp;rate=0&amp;pushid=2024121601&amp;bkt=0&amp;openid=o04IBAPKs97AVAr5VwEBkyNp1kBk&amp;tbkt=D&amp;ext=%7B%22pl%22%3A0%7D&amp;lrg=2&amp;allcmsids=WXN2024121600184400_WXN2024121600197400_WXN2024121600203000_WXN2024121600219900&amp;segmentNum=4874&amp;groupid=1734331092&amp;msgid=0&amp;cv=0x1800362f&amp;dt=13&amp;lang=zh_CN&amp;key=95ee5a5c2c1558ff165a2fc8d98d602c040298950eac7705790c980ce0c07cea2722a59f0a40b1f06459d76d4e145fbfd44183b7d99aabedd8b547ec5909f1503a57a9a3c8f22d40b659c7d92d32d322e63a2106dbfbdc739fd05bb81917c2aa4335cc45782c1d36e75f879be0059903336049cd1541c445bf610cd9288ac93b&amp;version=1800362f&amp;devicetype=iPad%20iPadOS16.1&amp;wuid=oDdoCt_dpSMp9bmqK3jx1JGsOwSY&amp;sharer=o04IBAPKs97AVAr5VwEBkyNp1kBk</contentUrl><mediaList><media><id>0</id><type>2</type><title></title><description></description><private>0</private><userData></userData><subType>0</subType><videoSize width="0" height="0"/><url type="0" md5="" videomd5="" >https://inews.gtimg.com/news_ls/ONe5cIAWuYXxUZQwVS62vM9K3pyLcYgpw_50Tr1nlni7oAA_8080/0</url><lowBandUrl type="0">https://inews.gtimg.com/news_ls/ONe5cIAWuYXxUZQwVS62vM9K3pyLcYgpw_50Tr1nlni7oAA_8080/0</lowBandUrl><thumb type="1">http://szmmsns.qpic.cn/mmsns/GLJjdhs1lmia6LPaUO8K9yjZC90ib1vWPIvBH88v1W2nImwPichwpmdspn59Geib5XIuA1b6Y3b93pU/150</thumb></media></mediaList></ContentObject></TimelineObject>

位置加视频号#

<TimelineObject><id>0</id><username>wxid_xxxxxxxxxxxx</username><createTime>1734347605</createTime><contentDesc> 视频号 </contentDesc><contentDescShowType>0</contentDescShowType><contentDescScene>4</contentDescScene><private>0</private><sightFolded>0</sightFolded><showFlag>0</showFlag><location city=" 武汉市 " longitude="114.410645" latitude="30.477043" poiName=" 光谷天地 " poiAddress=" 湖北省武汉市洪山区关山大道 519 号 "      poiScale="11.000000" poiInfoUrl="" poiClassifyId="qqmap_288134984679149398" poiClassifyType="1" poiClickableStatus="0" buildingId="420100216539" floorName="" /><appInfo><id></id><version></version><appName></appName><installUrl></installUrl><fromUrl></fromUrl><isForceUpdate>0</isForceUpdate><isHidden>0</isHidden></appInfo><sourceUserName></sourceUserName><sourceNickName> 视频号 </sourceNickName><statisticsData></statisticsData><statExtStr></statExtStr><ContentObject><finderFeed><objectId><![CDATA[14548030681484757242]]></objectId><feedType><![CDATA[4]]></feedType><nickname><![CDATA[ 傅盛讲 AI]]></nickname><avatar><![CDATA[https://wx.qlogo.cn/finderhead/ver_1/4CzIqSJ4LhtiaZ2abxyRMXORQeA89SVPvOltGqiaicTObNHicv4FHbicrwoYvLbFCTRNvOHkkFKN7tMHzQhnNAoCs6SXhmlGQmdMYkWjbiaukm3kPbOaKTTy7JAK4gKrGlQA63/0]]></avatar><desc><![CDATA[ 注意看,这个男人 45 岁。坚持 AI 创业七年,虽压力山大,但仍心潮澎湃 # 跟傅盛学 AI#AIGC# 大有学问 #AI# 机器人 ]]></desc><mediaCount><![CDATA[1]]></mediaCount><objectNonceId><![CDATA[5311870697128983641_0_0_0_0_0]]></objectNonceId><liveId><![CDATA[0]]></liveId><username><![CDATA[v2_060000231003b20faec8cae78d1cc2d3c905eb30b07740c8bdc4d90ed53035b990691f558a1d@finder]]></username><authIconUrl><![CDATA[https://dldir1v6.qq.com/weixin/checkresupdate/auth_icon_level3_2e2f94615c1e4651a25a7e0446f63135.png]]></authIconUrl><authIconType>1</authIconType><contactJumpInfoStr><![CDATA[]]></contactJumpInfoStr><sourceCommentScene>20</sourceCommentScene><mediaList><media><thumbUrl><![CDATA[http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=rjD5jyTuFrIpZ2ibE8T7YmwgiahniaXswqzNj1Sib5VmP6dP7htF7lCaEYkZfaWvLpXoS6ibIxvTJ7IBzvUKRJWjrsJ26GiasqMSzr4mjyF87USR4icqTqdNXhzBA&hy=SH&idx=1&m=&scene=0&uzid=2&picformat=200&token=Cvvj5Ix3eeyD0TVgRZ2eE54cqcyaRo9AJBPmibPKSBLsbRw7BB5R6XibOVWnickb7Ke04RiaJrt6PRdbw6deYKePBLBgJXevIkXKDaabVpkrmD9JRclVaPr0XrBfQbZDenzfTLDNsvibw7oXQTicVul3B5tvgon3nuodOH&ctsc=2-20]]></thumbUrl><fullCoverUrl><![CDATA[]]></fullCoverUrl><videoPlayDuration><![CDATA[202]]></videoPlayDuration><url><![CDATA[http://wxapp.tc.qq.com/251/20302/stodownload?encfilekey=Cvvj5Ix3eewK0tHtibORqcsqchXNh0Gf3sJcaYqC2rQC5hSDgs2JURx5icCOMNz4qBg5LdDIngHoFVscg9VlicTSQUPibszpyEgHu6rcWyhiaLvQPgXymHh5SKicHic5YQh1nOG&bizid=1023&dotrans=0&hy=SH&idx=1&m=&uzid=1]]></url><coverUrl><![CDATA[http://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=rjD5jyTuFrIpZ2ibE8T7YmwgiahniaXswqzNj1Sib5VmP6dP7htF7lCaEYkZfaWvLpXoS6ibIxvTJ7IBzvUKRJWjrsJ26GiasqMSzr4mjyF87USR4icqTqdNXhzBA&hy=SH&idx=1&m=&scene=0&uzid=2&picformat=200&token=Cvvj5Ix3eeyD0TVgRZ2eE54cqcyaRo9AJBPmibPKSBLsbRw7BB5R6XibOVWnickb7Ke04RiaJrt6PRdbw6deYKePBLBgJXevIkXKDaabVpkrmD9JRclVaPr0XrBfQbZDenzfTLDNsvibw7oXQTicVul3B5tvgon3nuodOH&ctsc=2-20]]></coverUrl><height><![CDATA[1920]]></height><mediaType><![CDATA[4]]></mediaType><width><![CDATA[1080]]></width></media></mediaList><megaVideo></megaVideo><bizUsername><![CDATA[]]></bizUsername><bizNickname><![CDATA[]]></bizNickname><bizAvatar><![CDATA[]]></bizAvatar><bizUsernameV2><![CDATA[]]></bizUsernameV2><bizAuthIconUrl><![CDATA[]]></bizAuthIconUrl><bizAuthIconType>0</bizAuthIconType><ecSource><![CDATA[]]></ecSource><lastGMsgID><![CDATA[]]></lastGMsgID><shareBypData><![CDATA[]]></shareBypData><isDebug>0</isDebug><content_type>0</content_type><finderForwardSource><![CDATA[]]></finderForwardSource></finderFeed><contentStyle>28</contentStyle><title> 当前微信版本不支持展示该内容,请升级至最新版本。</title><description></description><contentUrl>https://support.weixin.qq.com/update/</contentUrl><mediaList></mediaList></ContentObject></TimelineObject>

请求参数

Body 参数application/json
guid
string 
Guid
可选
默认值:
object_desc
string 
Object Desc
必需
with_user_list
array[string]
With User List
可选
block_user_list
array[string]
Block User List
可选
group_user_list
array[string]
Group User List
可选
group_contact_tag_id_list
array[integer]
Group Contact Tag Id List
可选
black_contact_tag_id_list
array[integer]
Black Contact Tag Id List
可选
示例
{
    "guid": "",
    "object_desc": "string",
    "with_user_list": [],
    "block_user_list": [],
    "group_user_list": [],
    "group_contact_tag_id_list": [],
    "black_contact_tag_id_list": []
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/sns/sns_post' \
--header 'Content-Type: application/json' \
--data-raw '{
    "guid": "",
    "object_desc": "string",
    "with_user_list": [],
    "block_user_list": [],
    "group_user_list": [],
    "group_contact_tag_id_list": [],
    "black_contact_tag_id_list": []
}'

返回响应

🟢200Successful Response
application/json
Body
string 
可选
示例
"string"
🟠422Validation Error
修改于 2025-07-02 07:39:52
上一页
获取好友朋友圈动态
下一页
获取朋友圈动态详细信息
Built with