发送图文文章
接口地址
域名:https://open.mindoffice.cn
uri : /open-platform/api/article/send_article_message
请求地址
https://open.mindoffice.cn/open-platform/api/article/send_article_message请求方式
POST+JSON
请求Header
app-id 系统分配
app-secret 系统分配
x-request-id 时间戳(毫秒) 或者 uuid.v4
请求Body参数
| 字段 | 类型 | 必须 | 描述 | 默认 | 示例值 |
|---|---|---|---|---|---|
| articles | string | 是 | 消息内容 | 无 | |
| receive_ids | []string | 否 | 批量接收人open_id 优先级高于 receive_id | 无 | ["on_xx","on_xx"] |
| receive_id | string | 否 | 文章接收人open_id 接收人都不传,则发送全量订阅用户 | 无 | on_xx |
| receive_type | int | 是 | 接受类型 1:订阅用户 | 无 | 1 |
| msg_type | string | 是 | 消息类型 article | 无 | article |
参数示例
{
"receive_id": "ou_7d8a6e6df7621556ce0d21922b676706ccs", // 用户 OpenId,如果为空且receive_ids为空 则发送所有人
"receive_ids": ["ou_7d8a6e6df7621556ce0d21922b676706ccs","ou_7d8a6e6df7621556ce0d21922b676706cc1"], // 批量接收人的OpenId,优先级高于 receive_id
"receive_type": 1, // 1
"articles": "{\"body\":{\"content\":\"123213\",\"format\":\"text\"},\"title\":\"这是新的文章\", \"abstract\": \"这事摘要\", \"thumb_url\": \"https://mind-open-platform.oss-cn-beijing.aliyuncs.com/ozhnssovf/202408/mind-open-platform/c98372e8-5b92-478f-a821-f6330b364b97/1723708106480/5130f8e190d90a005d49b025d209162b-wnwertk728xoipc76snuusc688.jpg\"}", // 消息内容
"msg_type": "article" // 消息类型
}
json_decode 后的 articles参数
| 字段 | 类型 | 必须 | 描述 | 默认 | 示例值 |
|---|---|---|---|---|---|
| title | string | 是 | 文章标题,上限64字 | 无 | title |
| abstract | string | 否 | 文章摘要,上限150字 | 无 | |
| thumb_url | string | 否 | 文章封面图 1、不传,随机生成 2、从默认图片库获取: 点击查看 默认图片地址 3、自行调用接口获取 API 上传图片获取图片地址 | 随机一张图片地址 | |
| enable_forward | Boolean | 否 | 是否可以转发 true:可以转发 false:不可以转发 | 默认true | |
| enable_forward_external | Boolean | 否 | 是否可以转发外部联系人 true:可以转发 false:不可以转发外部联系人 | 默认false | |
| body | object | 是 | 文章内容 | 无 | body: { format: "text", content: "纯文本" } |
| project_id | string | 否 | Mind项目ID/ 事项ID | 无 | ETJ6EO |
| tags | array | 否 | 标签 | 无 | tags:["LF","LS"] |
| display_mode | string | 否 | 展示方式 | native | iframe/native native和现在保持一致,iframe是文章页直接嵌入ifame地址 |
| source_url | string | 否 | 原文地址 | 无 | 只支持https 协议 |
text 格式的articles.body
| 字段 | 类型 | 必须 | 描述 | 默认 | 示例值 |
|---|---|---|---|---|---|
| format | 是 | String | text | 模块标签,固定值text。 | |
| content | 是 | String | 文章内容 | 纯文本内容 |
## json 字符串
{\"body\":{\"content\":\"123213\",\"format\":\"text\"},\"title\":\"这是新的文章\", \"abstract\": \"这事摘要\", \"thumb_url\": \"https://mind-open-platform.oss-cn-beijing.aliyuncs.com/ozhnssovf/202408/mind-open-platform/c98372e8-5b92-478f-a821-f6330b364b97/1723708106480/5130f8e190d90a005d49b025d209162b-wnwertk728xoipc76snuusc688.jpg\"}
## json 格式字符串解析后
{
"title": "", //文章标题
"abstract":"",//摘要纯文本
"thumb_url":"", //文章封面链接,支持JPG、PNG格式,较好的效果为大图480*270
"body":{
"format":"text"
"content":"各种格式类型:markdown、富文本、纯文本"
}, //文章内容
"enable_forward":tue //是否允许转发
}
rich_text 格式的articles.body
| 字段 | 类型 | 必须 | 描述 | 默认 | 示例值 |
|---|---|---|---|---|---|
| format | 是 | String | text | 模块标签,固定值rich_text。 | |
| content | 是 | Object | {"tag":"rich_text","content":[{"type":"paragraph","content":[{"type":"text","marks":[{"type":"bold"}],"text":"所有项目180天收入"}]}]} |
{\"abstract\":\"🌸这是标题\",\"body\":{\"content\":[{\"content\":[{\"marks\":[{\"type\":\"bold\"}],\"text\":\"所有项目180天收入\",\"type\":\"text\"}],\"type\":\"paragraph\"},{\"content\":[{\"text\":\"最后更新时间:2023-7-7发布人:桃子(每月3日09:15 推送)\",\"type\":\"text\"}],\"type\":\"paragraph\"}],\"format\":\"rich_text\"},\"title\":\"🧡季节更迭,新冠病毒防护不容松懈🧡\"}
{
"abstract": "🌸这是标题",
"body": {
"content": [
{
"content": [
{
"marks": [
{
"type": "bold"
}
],
"text": "所有项目180天收入",
"type": "text"
}
],
"type": "paragraph"
},
{
"content": [
{
"text": "最后更新时间:2023-7-7发布人:桃子(每月3日09:15 推送)",
"type": "text"
}
],
"type": "paragraph"
}
],
"format": "rich_text"
},
"title": "🧡季节更迭,新冠病毒防护不容松懈🧡"
}
markdown 格式的articles.body
| 字段 | 类型 | 必须 | 描述 | 默认 | 示例值 |
|---|---|---|---|---|---|
| format | 是 | String | text | 模块标签,固定值markdown。 | |
| content | 是 | String | 文章内容 |
{
"title": "", //文章标题
"abstract":"",//摘要纯文本
"thumb_url":"", //文章封面链接,支持JPG、PNG格式,较好的效果为大图480*270
"body":{
"format":"markdown"
"content":"### 各种格式类型:markdown、富文本、纯文本"
}, //文章内容
"enable_forward":tue //是否允许转发
}
返回参数
| 字段 | 类型 | 必须 | 描述 | 默认 | 示例值 |
|---|---|---|---|---|---|
| code | string | 是 | 状态码 | 200 | 200:成功非200:失败 |
| msg | string | 是 | 提示 | ||
| data | object | 否 |
{
"code": 200,
"msg": "OK",
"data": null
}
Curl 格式
curl -X POST --location "https://open.mindoffice.cn/open-platform/api/article/send_article_message" \
-H "Content-Type: application/json" \
-H "APP-ID: mind_bk18x2mqdnop8goi" \
-H "APP-Secret: 5Db6XFtyToJ6e3CKwAWHZoApgPUT7dmL" \
-d "{
\"receive_id\": \"ou_f7c92220ca7a0faedb2946b70fbe68c0\",
\"receive_type\": 1,
\"articles\": \"{\\\"thumb_url\\\":\\\"https://cdn-ali-file-pre-mind.im30.net/osnneztho/202409/mind-open-platform/6af6b80c-2e54-42c8-88a9-0f902331e5e8/1725331861807/2492422044583941979.jpg\\\",\\\"abstract\\\":\\\"15:38这是富文本 不允许转发\\\",\\\"enable_forward\\\":true,\\\"enable_forward_external\\\":true,\\\"body\\\":{\\\"content\\\":[{\\\"content\\\":[{\\\"marks\\\":[{\\\"type\\\":\\\"bold\\\"}],\\\"text\\\":\\\"所有项目180天收入\\\",\\\"type\\\":\\\"text\\\"}],\\\"type\\\":\\\"paragraph\\\"},{\\\"content\\\":[{\\\"text\\\":\\\"最后更新时间:2023-7-7发布人:桃子(每月3日09:15 推送)\\\",\\\"type\\\":\\\"text\\\"}],\\\"type\\\":\\\"paragraph\\\"}],\\\"format\\\":\\\"rich_text\\\"},\\\"can_share\\\":2,\\\"title\\\":\\\"一二三四五六七八九十一二三四五六七八九十一二三四五六七八九十一二\\\"}\",
\"msg_type\": \"article\"
}"
更新时间:2026-03-27