# 获取已发布图文信息

调试工具

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:freepublishGetarticle

本接口用于获取已发布的图文信息

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/cgi-bin/freepublish/getarticle?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用

# 第三方调用

  • 本接口支持第三方平台代商家调用。

  • 该接口所属的权限集 id 为:7

  • 服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填说明
access_tokenstring接口调用凭证,可使用 access_tokenauthorizer_access_token

# 请求体 Request Payload

参数名类型必填示例说明
article_idstringARTICLE_ID要获取的草稿的article_id

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
news_itemobjarray图文信息集合
errcodenumber错误码
errmsgstring错误描述

# Res.news_item(Array) Object Payload

图文信息集合

参数名类型说明
titlestring标题
authorstring作者
digeststring图文消息的摘要,仅有单图文消息才有摘要,多图文此处为空。如果本字段为没有填写,则默认抓取正文前54个字。
contentstring图文消息的具体内容,支持HTML标签,必须少于2万字符,小于1M,且此处会去除JS,涉及图片url必须来源 "上传图文消息内的图片获取URL"接口获取。外部图片url将被过滤。 图片消息则仅支持纯文本和部分特殊功能标签如商品,商品个数不可超过50个
content_source_urlstring图文消息的原文地址,即点击“阅读原文”后的URL
thumb_media_idstring图文消息的封面图片素材id(必须是永久MediaID)
thumb_urlstring图文消息的封面图片URL
need_open_commentnumber是否打开评论,0不打开(默认),1打开
only_fans_can_commentnumber是否粉丝才可评论,0所有人可评论(默认),1粉丝才可评论
urlstring草稿的临时链接
is_deletedboolean该图文是否被删除

# 4. 注意事项

本接口无特殊注意事项

# 5. 代码示例

请求示例

{
  "article_id": "ARTICLE_ID"
}

返回示例

{
  "news_item": [
    {
      "title": "TITLE",
      "author": "AUTHOR",
      "digest": "DIGEST",
      "content": "CONTENT",
      "content_source_url": "CONTENT_SOURCE_URL",
      "thumb_media_id": "THUMB_MEDIA_ID",
      "thumb_url": "THUMB_URL",
      "show_cover_pic": 1,
      "need_open_comment": 0,
      "only_fans_can_comment": 0,
      "url": "URL",
      "is_deleted": false
    }
  ]
}

# 6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码

错误码错误描述解决方案
0ok成功
48001api unauthorizedapi 功能未授权,请确认服务号已获得该接口,可以在公众平台官网 - 开发者中心页中查看接口权限
53600Article ID 无效无效的文章ID

# 7. 适用范围

本接口在不同账号类型下的可调用情况:
公众号服务号
仅认证 仅认证
  • 仅认证:表示仅允许企业主体已认证账号调用,未认证或不支持认证的账号无法调用
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口;