跳到主要内容

PUBLISHING / UNDERSTAND THE BOUNDARY

排版完成之后,怎样进入草稿箱?

排版 API 返回 HTML。创建草稿需要公众号凭证、适用的发布工具,以及明确的执行操作。

排版

Markdown → HTML

使用 md2wechat API Key,获得可预览的排版结果。

查看转换接口
草稿

排版内容 → 草稿箱

配置公众号与封面,检查准备情况后显式创建。

查看 CLI 草稿工作流

微信公众号发布 API 从哪里接入?

需要把内容写入公众号草稿箱时,先查阅国际站 Publishing API 文档。服务基础地址为 https://md2wechat.com/api/v1;认证方式、请求字段与素材要求以该文档为准。中文站 Convert API 负责生成 HTML,不能用转换结果代替草稿创建结果。

微信公众号草稿箱 API 需要准备什么?

先确认目标公众号及接口权限,准备 AppID / AppSecret、封面和可读取的正文图片,再按所用服务要求上传素材并创建草稿。记录返回结果,到公众号后台核对文章;遇到超时先查结果,再决定重试。

微信公众号自动发布可以自动到哪一步?

可把内容检查、排版和经过授权的草稿创建串联到程序或 Agent 工作流。正式发布与群发还受公众号权限和微信官方流程约束;本页不提供未经核实的群发端点,也不承诺无人审核自动上线。

创建草稿前检查

  • 确认目标公众号,准备该账号的 AppID / AppSecret 和所需接口权限。
  • 按所用接口要求配置 IP 白名单,核对实际请求的公网出口。
  • 封面与正文图片分别准备,确认文件路径或图片地址可读取;上传素材与创建草稿使用同一公众号。
  • 检查标题、正文和封面,明确授权后再创建草稿。

从检查到人工审核

  1. 先完成 Markdown 与结构检查
  2. 生成 HTML 预览并检查排版;预览可能调用转换服务,不代表已上传素材或创建草稿
  3. 人工确认账号与文章
  4. 明确授权后创建草稿
  5. 进入公众号后台,人工审核正文、封面和图片

失败后怎样继续

遇到的问题下一步
账号或凭证错误核对目标公众号、凭证及该账号权限;不要把完整密钥放入公开日志。
IP 不在白名单核对实际执行请求的公网出口;使用固定出口时核对服务提供的出口信息。
封面或正文图片不可读取封面与正文图片分别准备,核对实际路径或可访问地址,再处理素材上传。
请求超时请求超时后先确认草稿是否已创建:检查公众号后台草稿箱,并核对工具返回的草稿结果,再决定是否重试;不要连续重复提交。
请求受限根据所用服务的错误说明降低频率,避免并发重试;不假设服务具有去重保证。

发布常见问题

公众号排版 API 和公众号发布 API 有什么区别?

POST https://www.md2wechat.cn/api/convert 生成微信公众号 HTML,不会创建公众号草稿;https://md2wechat.com/api/v1 是国际站 Publishing API 的服务基础地址。

上传图片也需要公众号凭证

转换 HTML 不需要微信凭证,但需配置转换服务的 API Key。向公众号上传图片和创建草稿需要对应公众号的 AppID / AppSecret、接口权限,以及适用的 IP 白名单。创建草稿还需明确授权。

草稿不等于群发

本页指导创建可审核的公众号草稿。创建成功后,请进入公众号后台人工检查;正式发布或群发按该公众号权限和微信官方流程另行处理,创建草稿不会自动群发。

在哪里查看 Publishing API 的当前接口说明?

以国际站快速开始文档 https://www.md2wechat.com/zh/docs/quickstart 为准;中文站页面不复制可能变化的子端点或请求字段。