API接口文档

创建朋友圈

POST

/api/v2/wecom/moment/create

功能说明：

此接口可以通过传wecomUserId控制对应账号发送朋友圈

可以通过传externalUserId控制朋友圈的客户可见范围

请求参数

Query 参数

token

string

企业级接口调用凭证

必需

Body 参数application/json

wecomUserId

string

发送朋友圈的账号企业微信员工id

必需

scope

enum<integer>

朋友圈可见类型

必需

枚举值:

externalUserId

array[string]

可见客户企业微信外部联系人id，仅scope为2时生效

可选

title

string

朋友圈文案标题

必需

最多20个字

type

enum<integer>

朋友圈内容类型

必需

枚举值:

12345

images

object

图片类型

可选

图片尺寸长X宽总像素不超过 10800 x 1080，大小不超过 10M，支持JPG格式，最多可批量上传9张

text

string

文字描述

可选

urls

array[string]

图片链接

必需

video

object

视频类型

可选

支持.mp4格式文件，大小限制不超过10MB

text

string

视频文字描述

可选

url

string

视频链接

必需

link

object

链接类型

可选

source_url

string

原链接

必需

title

string

标题

必需

最多100个字

thumbnail_url

string

封面地址

必需

description

string

描述

必需

最多100个字

text

string

文字描述

必需

channel

object

视频号类型

可选

avatar

string

头像地址

必需

cover_url

string

封面地址

必需

desc

string

描述

必需

extras

string

额外信息，根据接收到的字段内容填写

必需

feed_type

number

视频号类型，固定为4

必需

nickname

string

昵称

必需

thumb_url

string

缩率图地址

必需

url

string

视频号地址

必需

text

string

文字描述

必需

text

object

纯文本类型

可选

2000个字

text

string

文字描述

必需

示例

{
  "externalUserId": "40",
  "title": "下非期数真",
  "type": 4,
  "wecomUserId": "37",
  "scope": 1,
  "link": {
    "source_url": "http://lyiol.mn/ntjnsitvto",
    "title": "率力集",
    "thumbnail_url": "http://kitcidi.ms/prqikhne",
    "description": "运算音标特节工八选引种水。由基算都反形多取则济必期月。长除运月段民事团部约很须特己济。设件必这最圆极制计县量非展段查。",
    "text": "ut sed nulla ad occaecat"
  },
  "channel": {
    "avatar": "http://dummyimage.com/100x100",
    "cover_url": "http://liiql.gn/avtogba",
    "desc": "commodo",
    "extras": "exercitation do occaecat ea",
    "feed_type": 20,
    "nickname": "贾涛",
    "thumb_url": "http://unqne.tj/xckqcg",
    "url": "http://gtlkcpnbty.aero/gidq",
    "text": "fugiat do nostrud nulla ad"
  },
  "video": {
    "text": "id mollit aliquip irure",
    "url": "http://uxdm.bg/peycrciyvu"
  },
  "text": "ea dolor elit dolore",
  "images": {
    "text": "consequat occaecat",
    "urls": [
      "velit Lorem irure ullamco et"
    ]
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v2/wecom/moment/create?token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "externalUserId": "40",
    "title": "下非期数真",
    "type": 4,
    "wecomUserId": "37",
    "scope": 1,
    "link": {
        "source_url": "http://lyiol.mn/ntjnsitvto",
        "title": "率力集",
        "thumbnail_url": "http://kitcidi.ms/prqikhne",
        "description": "运算音标特节工八选引种水。由基算都反形多取则济必期月。长除运月段民事团部约很须特己济。设件必这最圆极制计县量非展段查。",
        "text": "ut sed nulla ad occaecat"
    },
    "channel": {
        "avatar": "http://dummyimage.com/100x100",
        "cover_url": "http://liiql.gn/avtogba",
        "desc": "commodo",
        "extras": "exercitation do occaecat ea",
        "feed_type": 20,
        "nickname": "贾涛",
        "thumb_url": "http://unqne.tj/xckqcg",
        "url": "http://gtlkcpnbty.aero/gidq",
        "text": "fugiat do nostrud nulla ad"
    },
    "video": {
        "text": "id mollit aliquip irure",
        "url": "http://uxdm.bg/peycrciyvu"
    },
    "text": "ea dolor elit dolore",
    "images": {
        "text": "consequat occaecat",
        "urls": [
            "velit Lorem irure ullamco et"
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

momentId

string

必需

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "momentId": "66306cf673728199f19b9d5e"
}

修改于 2025-02-26 07:13:52

删除朋友圈

创建朋友圈回调