百家号后台里面有一个开发选项，对于普通百家号用户来说可能没什么用，但是对于会编程、会做网站的人来说就是超级福利。如果你是一个开发者，并且你正在运营网站或者其它内容服务平台，那么百家号开放的API会特别有用。

百家号开发是什么？能干什么？

百家号为开发者用户提供了基础能力的接入文档、在线调试工具等，助力开发者快速完成自有平台与百家号平台的对接、发布与管理优质内容，高效灵活地运营帐号。通俗来说，就是可以将自己的平台和百家号进行内容的对接。这样更方便内容的管理。比如如果你有一个网站、微信小程序、博客等内容运营平台，那么你在平台上发布的文章可以直接一键发布到百家号平台上，真的特别方便。

如何使用接口？

这里不得不吐槽一下百家号开发者文档的制作者了，很多说明不清晰，容易误导开发者。笔者摸索了很长时间才弄好图文发布接口。其实是很简单的发送post请求，主要有一些“大坑”需要注意，下面来详细说明使用要点，以图文发布接口为例。

要点一：开发者文档提供了接口的地址，并且说明了要传递的参数。如下图所示。

这里有一个大坑，开发者文档中的参数示例是json的形式，开始一直以为post传递过去的就是json格式的字符串，试了很长时间一直说参数错误，通过百家号给出的在线调试工具就能返回正确的结果，最后用审查元素看了一下在线调试工具发送的请求头，就明白为什么了，原来请求头并不是json格式的字符串，而是普通的字符串。果然改回来立刻就收到了成功的结果。

要点二：注意origin_url这个参数，文档上是这样解释的：原文地址，相同URL的文章会被认为是同一篇文章，禁止提交

这句号是这个意思：如果这个参数没有改变，那么这个接口只认为你第一次提交的数据是有效的，再次提交将不会保存提交的数据，依然以第一次提交的数据为准，即使你这篇文章已经被你删除掉了，但是它是有返回值的，返回会文章的id，而同一个URL返回的文章id是不变的，注意这个文章id特别重要、重要、重要。

要点三：虽然你成功提交了数据，接口返回结果也是success，但是有可能你还是无法在百家号内容管理、或者草稿中找到你通过接口发布的文章。注意看文档中这一句话：用户上传的图片/视频素材在异步处理的过程中，可能存在处理失败/超时等情况，含有此类素材的文章将不会显示在文章列表，可以使用获取文章状态API定位问题。这句话表示：如果你提交的封面图访问不到，或者文章主题内容中的图片访问不到，就无法在百家号后台中看到这篇文章。

那么一般在网站上发布的文章，里面图片的src链接都是相对地址，发送给百家号这个接口，百家号自然无法请求到图片文件，所以在发送之前，必须将src地址变成以http协议开头的绝对地址才行。

其实百家号提供了另外一个接口：文章状态接口，通过前面请求接口成功后返回的文章id进行文章状态查询，会返回文章的状态，每一种状态对应不同的原因。靠这个接口，你就能知道文章为什么没有出现在百家号后台中。

要点四：不支持转义字符。技术类文章难免会有代码，那么其中必定会有一些特殊字符，这些字符经过转义才能在浏览器上显示，但是百家号图文接口不支持转义字符，一旦遇到转义字符，就会把后面的文章内容全部切掉。这个问题笔者刚刚才发现，还没想好怎么解决。

本文系小博客网站原创，转载请注明文章链接地址