企微协议 SAAS
  1. 朋友圈
企微协议 SAAS
  • 必读文档(问问题前先看完这里)
  • 枚举类
  • 回调
  • 客户端
    • 升级实例
      POST
    • 恢复实例
      POST
    • 停止实例
      POST
    • 设置实例通知地址
      POST
    • 设置实例桥接ID
      POST
    • 设置实例代理
      POST
  • 登录
    • 获取登录二维码
      POST
    • 检查登录二维码
      POST
    • 推送手机确认登录通知
      POST
    • 登录验证码
      POST
    • 自动登录
      POST
    • 扫码登录[无需调用]
      POST
    • 保持登录[无需调用]
      POST
  • 用户
    • 获取当前帐号信息
      POST
    • 获取当前帐号公司信息
      POST
    • 登出
      POST
    • 获取二维码名片 (新)
      POST
    • 获取二维码名片
      POST
    • 获取绑定的微信信息
      POST
  • 消息
    • 发送文本消息
    • 发送群@消息
    • 发送语音消息
    • 发送位置消息
    • 发送图片消息
    • 发送文件消息
    • 发送视频消息
    • 发送大视频消息
    • 发送Gif消息
    • 发送Gif消息
    • 发送名片
    • 发送链接
    • 发送小程序
    • 发送视频号
    • 获取语音消息翻译id
    • 获取语音消息翻译结果
    • 确认企微内部消息已读
    • 撤回消息
    • 标记会话已读
    • 发送聊天合集(合并转发)
    • 发送视频号直播
    • 发送引用消息
    • 发送微信小店商品信息
  • 联系人
    • 同步联系人
    • 同步申请好友列表
    • 批量获取用户信息
    • 批量获取公司信息
    • 更新联系人
    • 搜索微信/企微用户
    • 添加搜索的微信用户
    • 添加搜索的企微用户
    • 添加名片为联系人
    • 通过二维码名片添加微信用户
    • 添加被对方的删除联系人
    • 同意联系人申请
    • 删除联系人
    • 通过二维码获取联系人
    • 操作黑名单
  • 群聊
    • 获取客户群列表(自己是群主)
    • 批量获取群详细信息
    • 批量获取群成员详细信息
    • 增量同步群信息
    • 创建外部群
    • 创建内部群
    • 创建空的外部群
    • 修改群名称
    • 邀请/添加群成员
    • 移除群成员
    • 修改群公告
    • 转让群主
    • 添加群管理员
    • 移除群管理员
    • 开启/关闭群邀请确认
    • 退出群
    • 解散群
    • 添加群联系人
    • 通过群邀请链接进群
    • 修改群内昵称
    • 修改群备注
    • 获取群二维码
    • 开启/关闭禁止互相添加为联系人、禁止修改群名接口
    • 设置群自动回复
  • 云存储
    • 更新CDN信息
    • C2C CDN上传
    • C2C CDN下载
    • Big CDN上传
    • Big CDN下载
    • 微信CDN下载
    • 极速群发图片上传
    • 上传视频预览图
  • 标签
    • 同步获取标签列表
    • 创建标签
    • 批量为成员添加标签
    • 删除标签
    • 修改标签
    • 为成员添加多个标签
  • 朋友圈
    • 获取发布的朋友圈记录
      POST
    • 设置朋友圈封面
      POST
    • 设置朋友圈签名
      POST
    • 发布朋友圈
      POST
    • 删除朋友圈
      POST
    • 点赞
      POST
    • 评论
      POST
    • 获取指定朋友圈详情
      POST
    • 删除评论
      POST
  • 同步
    • 推送同步消息
    • 同步联系人数据
    • 同步消息
  1. 朋友圈

发布朋友圈

POST
/sns/post_sns
Sns

说明#

发布朋友圈可支持文本+视频/链接/多图片/视频号,不可支持多种格式,其中图片视频需要用到 BIGCDN 上传,视频需要传封面图与视频内容

参数说明#

链接信息#

link_info:
{
  "title": "",
  "content_url": ""
}
链接没有封面图,如需封面图加 media_list 图片

媒体文件信息#

media_list:
这里面的参数 用 bigcdn 上传, 其中 file_type 字段
1 是图片
2 是视频
3 是缩略图
{
  "file_type": 1,
  "file_id": "",
  "file_size": 1024,
  "file_md5": "",
  "width": 300,
  "height": 240
}

视频号信息#

finder_info:
{
  "nickname": "",
  "url": "",
  "feed_type": 0,
  "cover_url": "",
  "thumb_url": "",
  "avatar": "",
  "desc": "",
  "extras": ""
}

位置信息:#

poi_info:
{
  "city": "",
  "latitude": "",
  "longitude": "",
  "poi_address": "",
  "poi_classifyid": "",
  "poi_classifytype": "",
  "poi_clickable_status": "",
  "poi_name": "",
  "poi_scale": "",
}

请求参数

Body 参数application/json
guid
string 
Guid
必需
content
string 
Content
可选
默认值:
user_list
array[string]
User List
可选
link_info
object 
Link Info
可选
默认值:
{}
media_list
array [object] 
Media List
可选
finder_info
object 
Finder Info
可选
默认值:
{}
poi_info
object 
Poi Info
可选
默认值:
{}
示例
{
  "content": "nostrud in do dolore",
  "user_list": [
    "78813022xxx98"
  ],
  "link_info": {
    "title": "百度一下",
    "content_url": "https://www.baidu.com"
  },
  "media_list": [
    {
      "file_id": "*1*F34hSNMREYF+BNgTfNtYo7Lg5/va+EoTPkyESrZSpwveUtI8Z8Zylqtm+6z4Q5mxctuYc0EZqtCw3OsQ2RXDKfMnQF1PNmNuDnUg6efswhVsyMVW7XccinYpk6PabggQVXwjuCbMTO3IQGWDwa8ls7KOvB3dAg9vU93vsACDWzkU6DCZy3MgILrRhlxacjiUbJRVapy9NpKlW/MjCFz0qRuhOtstB3Md3jHvsZm0Ww3z0ZIa3FAYepKTfN0XbbCUOA43dpsFCj46micLbizlVaSc4H+Yr597XuqL5bWylz8h6kLkj5INFia+gfqniDLYdXw2MRuXbkmcqKNx2KhNHnRmGO2/E0vXDR6E5FbJsT7t3qhuxR9HyE80G+HwlQg78uwFxTVarWyzORsbsm1J7L2fXLSM/UOBbLLKw2AkKsgDkY4H8v5DbL/3ts5bORbm/Zj1RPfuqk/ooZO/hwXAZLkAKh9VRrjVL4BjYyRuQok=",
      "file_size": 270748,
      "video_duration": 15,
      "file_type": 2
    },
    {
      "file_id": "*1*F34hSNMREYF+BNgTfNtYo7Lg5/va+EoTPkyESrZSpwveUtI8Z8Zylqtm+6z4Q5mxctuYc0EZqtCw3OsQ2RXDKfMnQF1PNmNuDnUg6efswhVsyMVW7XccinYpk6PabggQVXwjuCbMTO3IQGWDwa8ls7KOvB3dAg9vU93vsACDWzkU6DCZy3MgILrRhlxacjiUbJRVapy9NpKlW/MjCFz0qRuhOtstB3Md3jHvsZm0Ww3z0ZIa3FAYepKTfN0XbbCUOA43dpsFCj46micLbizlVaSc4H+Yr597XuqL5bWylz8h6kLkj5INFia+gfqniDLYdXw2MRuXbkmcqKNx2KhNHnRmGO2/E0vXDR6E5FbJsT7t3qhuxR9HyE80G+HwlQg78uwFxTVarWyzORsbsm1J7L2fXLSM/UOBbLLKw2AkKsgDkY4H8v5DbL/3ts5bORbm/Zj1RPfuqk/ooZO/hwXAZLkAKh9VRrjVL4BjYyRuQok=",
      "file_size": 70748,
      "file_type": 3
    }
  ],
  "finder_info": {
    "avatar": "http://wx.qlogo.cn/finderhead/Q3auHgzwzM6HSWYDSpFAYCx2KWvRguyFSpCvZwTA5C7iaP7ezkYAGVQ/0",
    "cover_url": "http://wxapp.tc.qq.com/251/20350/stodownload?encfilekey=XGocBFxVWK5dcyOOqpEU4yZ0ia4qlCRBBg1e4YghaftniaDwu7yHDhoIS57QV9m8OewZFxh5PJtjZbrmdb1XBhQHCAON3bV8K4Oa6D8afdvt5WxCF32S8dsuEGY09mHkwZz7GQZ5iaiaT05jciauBujdicB3r9bJ3SwwcuFK5lhnoKu3jNtEH0r6Mc5bVRyx01Gu7W&adaptivelytrans=0&bizid=1023&dotrans=0&hy=SZ&idx=1&m=c519536087668c32080cdda9c8c2e641&token=6xykWLEnztLEWV55LzmMttpgJ35bzDbsVGkuOic0DibTge4ylcibJa7jm3ZBSUIQYGRTsuu09EndGU&finder_expire_time=1649778256&finder_eid=export%2FUzFfAgtgekIEAQAAAAAAE18X7n6gugAAAAstQy6ubaLX4KHWvLEZgBPE2qMgO380DPn9zNPgMIAZurq07zX40HP0Ng0BAokj",
    "desc": "这医生真奇怪,听都听不懂#搞笑视频",
    "extras": "CAEQACLQKwAE9OmXBAAAAQAAAAAAoNvpOPuI2w+==",
    "feed_type": 4,
    "nickname": "夢佳baby",
    "thumb_url": "http://wxapp.tc.qq.com/251/20350/stodownload?encfilekey=XGocBFxVWK5dcyOOqpEU4yZ0ia4qlCRBBg1e4YghaftniaDwu7yHDhoIS57QV9m8OewZFxh5PJtjZbrmdb1XBhQHCAON3bV8K4Oa6D8afdvt5WxCF32S8dsuEGY09mHkwZz7GQZ5iaiaT05jciauBujdicB3r9bJ3SwwcuFK5lhnoKu3jNtEH0r6Mc5bVRyx01Gu7W&adaptivelytrans=0&bizid=1023&dotrans=0&hy=SZ&idx=1&m=c519536087668c32080cdda9c8c2e641&token=6xykWLEnztLEWV55LzmMttpgJ35bzDbsVGkuOic0DibTge4ylcibJa7jm3ZBSUIQYGRTsuu09EndGU&finder_expire_time=1649778256&finder_eid=export%2FUzFfAgtgekIEAQAAAAAAE18X7n6gugAAAAstQy6ubaLX4KHWvLEZgBPE2qMgO380DPn9zNPgMIAZurq07zX40HP0Ng0BAokj",
    "url": "https://channels.weixin.qq.com/web/pages/feed?eid=export%2FUzFfAgtgekIEAQAAAAAAE18X7n6gugAAAAstQy6ubaLX4KHWvLEZgBPE2qMgO380DPn9zNPgMIAZurq07zX40HP0Ng0BAokj"
  },
  "guid": "80"
}

示例代码

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/post_sns' \
--header 'Content-Type: application/json' \
--data-raw '{
    "content": "nostrud in do dolore",
    "user_list": [
        "78813022xxx98"
    ],
    "link_info": {
        "title": "百度一下",
        "content_url": "https://www.baidu.com"
    },
    "media_list": [
        {
            "file_id": "*1*F34hSNMREYF+BNgTfNtYo7Lg5/va+EoTPkyESrZSpwveUtI8Z8Zylqtm+6z4Q5mxctuYc0EZqtCw3OsQ2RXDKfMnQF1PNmNuDnUg6efswhVsyMVW7XccinYpk6PabggQVXwjuCbMTO3IQGWDwa8ls7KOvB3dAg9vU93vsACDWzkU6DCZy3MgILrRhlxacjiUbJRVapy9NpKlW/MjCFz0qRuhOtstB3Md3jHvsZm0Ww3z0ZIa3FAYepKTfN0XbbCUOA43dpsFCj46micLbizlVaSc4H+Yr597XuqL5bWylz8h6kLkj5INFia+gfqniDLYdXw2MRuXbkmcqKNx2KhNHnRmGO2/E0vXDR6E5FbJsT7t3qhuxR9HyE80G+HwlQg78uwFxTVarWyzORsbsm1J7L2fXLSM/UOBbLLKw2AkKsgDkY4H8v5DbL/3ts5bORbm/Zj1RPfuqk/ooZO/hwXAZLkAKh9VRrjVL4BjYyRuQok=",
            "file_size": 270748,
            "video_duration": 15,
            "file_type": 2
        },
        {
            "file_id": "*1*F34hSNMREYF+BNgTfNtYo7Lg5/va+EoTPkyESrZSpwveUtI8Z8Zylqtm+6z4Q5mxctuYc0EZqtCw3OsQ2RXDKfMnQF1PNmNuDnUg6efswhVsyMVW7XccinYpk6PabggQVXwjuCbMTO3IQGWDwa8ls7KOvB3dAg9vU93vsACDWzkU6DCZy3MgILrRhlxacjiUbJRVapy9NpKlW/MjCFz0qRuhOtstB3Md3jHvsZm0Ww3z0ZIa3FAYepKTfN0XbbCUOA43dpsFCj46micLbizlVaSc4H+Yr597XuqL5bWylz8h6kLkj5INFia+gfqniDLYdXw2MRuXbkmcqKNx2KhNHnRmGO2/E0vXDR6E5FbJsT7t3qhuxR9HyE80G+HwlQg78uwFxTVarWyzORsbsm1J7L2fXLSM/UOBbLLKw2AkKsgDkY4H8v5DbL/3ts5bORbm/Zj1RPfuqk/ooZO/hwXAZLkAKh9VRrjVL4BjYyRuQok=",
            "file_size": 70748,
            "file_type": 3
        }
    ],
    "finder_info": {
        "avatar": "http://wx.qlogo.cn/finderhead/Q3auHgzwzM6HSWYDSpFAYCx2KWvRguyFSpCvZwTA5C7iaP7ezkYAGVQ/0",
        "cover_url": "http://wxapp.tc.qq.com/251/20350/stodownload?encfilekey=XGocBFxVWK5dcyOOqpEU4yZ0ia4qlCRBBg1e4YghaftniaDwu7yHDhoIS57QV9m8OewZFxh5PJtjZbrmdb1XBhQHCAON3bV8K4Oa6D8afdvt5WxCF32S8dsuEGY09mHkwZz7GQZ5iaiaT05jciauBujdicB3r9bJ3SwwcuFK5lhnoKu3jNtEH0r6Mc5bVRyx01Gu7W&adaptivelytrans=0&bizid=1023&dotrans=0&hy=SZ&idx=1&m=c519536087668c32080cdda9c8c2e641&token=6xykWLEnztLEWV55LzmMttpgJ35bzDbsVGkuOic0DibTge4ylcibJa7jm3ZBSUIQYGRTsuu09EndGU&finder_expire_time=1649778256&finder_eid=export%2FUzFfAgtgekIEAQAAAAAAE18X7n6gugAAAAstQy6ubaLX4KHWvLEZgBPE2qMgO380DPn9zNPgMIAZurq07zX40HP0Ng0BAokj",
        "desc": "这医生真奇怪,听都听不懂#搞笑视频",
        "extras": "CAEQACLQKwAE9OmXBAAAAQAAAAAAoNvpOPuI2w+==",
        "feed_type": 4,
        "nickname": "夢佳baby",
        "thumb_url": "http://wxapp.tc.qq.com/251/20350/stodownload?encfilekey=XGocBFxVWK5dcyOOqpEU4yZ0ia4qlCRBBg1e4YghaftniaDwu7yHDhoIS57QV9m8OewZFxh5PJtjZbrmdb1XBhQHCAON3bV8K4Oa6D8afdvt5WxCF32S8dsuEGY09mHkwZz7GQZ5iaiaT05jciauBujdicB3r9bJ3SwwcuFK5lhnoKu3jNtEH0r6Mc5bVRyx01Gu7W&adaptivelytrans=0&bizid=1023&dotrans=0&hy=SZ&idx=1&m=c519536087668c32080cdda9c8c2e641&token=6xykWLEnztLEWV55LzmMttpgJ35bzDbsVGkuOic0DibTge4ylcibJa7jm3ZBSUIQYGRTsuu09EndGU&finder_expire_time=1649778256&finder_eid=export%2FUzFfAgtgekIEAQAAAAAAE18X7n6gugAAAAstQy6ubaLX4KHWvLEZgBPE2qMgO380DPn9zNPgMIAZurq07zX40HP0Ng0BAokj",
        "url": "https://channels.weixin.qq.com/web/pages/feed?eid=export%2FUzFfAgtgekIEAQAAAAAAE18X7n6gugAAAAstQy6ubaLX4KHWvLEZgBPE2qMgO380DPn9zNPgMIAZurq07zX40HP0Ng0BAokj"
    },
    "guid": "80"
}'

返回响应

🟢200Successful Response
application/json
Body
No schema defined
示例
{
  "error_code": 0,
  "error_message": "ok",
  "data": {
    "base_rsp": {
      "ret_code": 0
    },
    "post_info": {
      "sid": "7351479041550445666",
      "author_vid": "1688854350501541",
      "seq": "1711649597448",
      "time": 1711649597,
      "content": "test",
      "postid": "CAUQvOaWsAYYkuHY+NWHwOAXILO+3IUK",
      "flag": 0,
      "update_time": "1711649597448",
      "type": 0,
      "task_sid": "0",
      "link_info": {},
      "poi_info": {},
      "visible_type": 1
    },
    "limtline": {
      "valid_time": "78403",
      "tips": ""
    },
    "corplimtline": {
      "valid_time": "78403",
      "tips": ""
    },
    "total_send_cnt": 1
  }
}
🟠422Validation Error
上一页
设置朋友圈签名
下一页
删除朋友圈
Built with