一文简述,通过公众号api接口发表文章

一文简述,通过公众号api接口发表文章

某次在站内更新下资源,期望能自动触发更新公众号,便有了这个需求。
查了下资料和文档,整了一个,记录分享下。

(对流程不感兴趣,只想代码的,直接拖到最后有代码)

准备前工作

1 开通开发配置

在公众号后台的「设置与开发」-「基本配置」,启用“开发者密码”,获取到AppID和AppSecret。

2 配置IP 白名单

在公众号后台的「设置与开发」-「基本配置」,“IP白名单”设置即可,把你的ip(执行api调用的机器ip)添加进去。

没有添加,发起请求会 “errcode: 40164,errmsg: invalid ip”。

接口封装

发布文章一共就四步:获取token、上传封面、保持草稿、发布。

1 获取token

几乎所有的接口都用token做身份认证的,接口功能调用的第一步。

参考文档:https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html

调用接口为:

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={yourappid}&secret={yoursecret}

用postman来做请求测试:

代码:(去除了日志信息,下同)

2 新增一个永久素材

主要是后面的操作,需要一个图片作为封面,所以需要提前上传一个图片资源,对应的接口就是“新增永久素材”了。

参考文档:

https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Adding_Permanent_Assets.html

调用接口:

https://api.weixin.qq.com/cgi-bin/material/add_material?access_token={access_token}&type=image

注意:如果多次发布文章,使用同样的封面,则可以先调用这个接口,把media_id 保存下来,之后这步就不是必要的了,后面新建草稿时候,直接用写定的media_id就可。

3 新建草稿

参考文档:https://developers.weixin.qq.com/doc/offiaccount/Draft_Box/Add_draft.html

调用接口:

https://api.weixin.qq.com/cgi-bin/draft/add?access_token={access_token}

填上我们关注的必填选就可,需要填写的不多。

代码:

注意:如果发布后,内容有乱码,如

那是编码问题,构造json 数据时候,ensure_ascii 用false。

上例是python代码,如果json.dumps(drafts)会出错,需要改为:json.dumps(drafts, ensure_ascii=False).encode(‘utf-8’) 。

其他语言也有对应的设置方法。

4 发布接口

最后一步就是发布了,这个接口最为简单。直接把前面的增加草稿返回的media_id 提交下就可。

参考文档:https://developers.weixin.qq.com/doc/offiaccount/Publish/Publish.html

调用接口:

https://api.weixin.qq.com/cgi-bin/freepublish/submit?access_token={access_token}

代码:

5 其他

这步不是必要的,不关注发布状态的就可以无视。

由于发布文章是异步的,同时发布后的文章可能还被内容审核啥的,所以发布后的文章,可以通过publish_id 去请求“发布状态轮询接口”接口查询状态。

整合发表功能

基本函数封装好之后,发表文章就是一步到位了:

特别提醒:

现在公众号是推荐制度,测试结果:通过api发布的文章,不会触发微信系统推荐,也不会在主页,可用于菜单或者链接分享方式给用户阅读。

完整代码:

#-*- coding: UTF-8 -*-

import json
import os
import requests

def _str_of_json(content, key):
    res = json.loads(str(content, 'utf8'))
    if key not in res or res[key] == "":
        print(res)
        return False, ""

    return True, res[key]


# 获取token 返回(sucess, token)
def get_token(appid, secret):
    url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=%s&secret=%s" % (appid, secret)
    res = requests.get(url)

    return _str_of_json(res.content, "access_token")


# 上传图片 返回(sucess, media_id)
def upload_image(token, file_path):
    url = "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=%s&type=image" % token

    with open(file=file_path, mode='rb') as fp:
        files = {'media': fp}
        resp = requests.post(url, files=files)

        return _str_of_json(resp.content, "media_id")

    return False, ""


# 新建草稿 返回(sucess, media_id)
def add_draft(token, cover_media_id, title, content):
    url = "https://api.weixin.qq.com/cgi-bin/draft/add?access_token=%s" % token

    article = {
        "title":title,
        "thumb_media_id":cover_media_id,
        "content":content,
        # "author":"author", # 非必填
        # "digest":"digest", # 非必填
    }

    drafts = {
        "articles":[
            article
        ]
    }

    headers = {'Content-Type': 'application/json'}
    # 直接post json.dumps(drafts) 会有乱码,所以
    post_data = json.dumps(drafts, ensure_ascii=False).encode('utf-8')
    res = requests.post(url, data=post_data, headers=headers)

    return _str_of_json(res.content, "media_id")

# 发布,返回(sucess, publish_id)
def publish(token, draft_id):
    url = "https://api.weixin.qq.com/cgi-bin/freepublish/submit?access_token=%s" % token
    res = requests.post(url, json={"media_id":draft_id})

    return _str_of_json(res.content, "publish_id")


def publish_article(appid, secret, title, content, cover_file_path):

    # 1 获取token
    res, token = get_token(appid, secret)

    # 2 上传封面
    res, cover_media_id = upload_image(token, cover_file_path)

    # 3 保存草稿
    ret, draft_id = add_draft(token, cover_media_id, title, content)

    # 4 发布
    ret, publish_id = publish(token, draft_id)


if __name__ == '__main__':
    appid = "wx000000000000" # 你的 appid
    secret = "xxxxxxxxxxxxxxx" # 你的 secret

    file_path = "/Users/xxx/yyyy.jpg" # 你的文章封面图片
    title = "你的文章标题"
    content = "你的文章内容"

    publish_article(appid, secret, title, content, file_path)

(全文完)

(欢迎转载本站文章,但请注明作者和出处 云域 – Yuccn

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注