SonicBot

百家号开发者文档最新版
1. 背景百家号为创作者提供自主开发接入百家号的方案,开发者可通过使用我们提供的接口服务,将图文、视频等内容接入至...
扫描右侧二维码阅读全文
19
2019/03

百家号开发者文档最新版

1. 背景

百家号为创作者提供自主开发接入百家号的方案,开发者可通过使用我们提供的接口服务,将图文、视频等内容接入至百家号平台内。

2. 使用对象

本接口服务适用于经过有效注册及申请后,以自身名义开发并对传输内容承担相应责任的开发者。

3. 开发流程与使用规范

3.1 开发流程

仔细阅读、同意并遵守百家号服务协议及开发者使用规范 —— 获取app_token及app_id —— API 对接 —— 接入内容至百家号平台内

3.2 使用规范

开发者在进行内容接入开发时,需要满足各个接口的规范限制,同时要注意传输内容符合百家号信息内容规范。

  1. 开发者在使用百家号接口文档时,所有使用方式必需按照文档中规定的方式使用,如有不明确之处,需要与百家号进行沟通;
  2. 接入文档中全部的接口,开发者只能在当前合作的内容传输方式中使用,不得通过任何方式提供给其他产品使用;
  3. 开发者获取到的app_token是调用百家号接口的关键凭证,开发者需妥善保管,若app_token泄露或丢失,需要在第一时间内进行重置;
  4. 开发者需传输符合百家号服务协议中的数据,为了保证用户体验,百家号会对其他平台的推广信息进行屏蔽;
  5. 开发者通过接口传输的数据遵循百家号的统一审核标准,百家号将主动拒绝不符合发布要求的内容;
  6. 开发者通过接口可推送的内容篇数受作者每日可发文篇数的统一限制;

4. 发布图文

4.1 接入流程

账号状态:发布图文内容的百家号账号状态正常
获取授权:同意开发者使用规范,获取app_token
创建文章:创建图文内容
调用接口:调用发布图文内容接口

4.2 接口地址

URL:http://baijiahao.baidu.com/builderinner/open/resource/article/publish

4.3 接口参数

参数名称类型是否必需描述
app_idstring作者帐号ID
app_tokenstring授权密钥
titlestring文章标题,限定8-40个中英文字符以内
contentstring正文内容,限制20000个中英文字符内,富文本
origin_url string原文地址
cover_imagesjson文章封面图片地址url, 0-3张封面图,封面图尺寸不小于218*146,可以为空,没有封面图的内容将会进入草稿
is_originalint标定是否原创,1 为原创,0 为非原创

4.4 注意

为了避免文章重复同步,百家号会做去重策略,相同文章禁止重复提交

4.5 返回值及解释

返回值类型描述
errnoint错误码
errmsgstring错误信息
dataarray返回数据

4.6 发布图文示例

      {
          "app_id" : "INPUT_ID_HERE",
          "app_token" : "INPUT_TOKEN_HERE",
          "title": "北京日报联合百家号,内容、技术相互赋能",
          "cover_images": "[{\"src\":\"https:\/\/pic.rmb.bdstatic.com\/0a9d9bb7c79f1d884a1e3f2cf67840d9.jpeg\"},{\"src\":\"https:\/\/pic.rmb.bdstatic.com\/9be6b6a7aa6d77782e55451d3b5e2e05.jpeg\"},{\"src\":\"https:\/\/pic.rmb.bdstatic.com\/a7b60cf66811e27d7f7466f88ba176e5.jpeg\"}]",
          "origin_url":"http://baijiahao.baidu.com/s?id=1565707368004927",
          "is_original" : 1,
          "content": "<p>12月14日,<strong>本句会加粗:北京日报集团与百家号战略合作发布会在京举行。</strong>北京市委副秘书长、宣传部副部长余俊生,北京日报社总编辑伍义林及北京市相关区县宣传部、融媒体中心领导、百度副总裁、百度百家号总经理等参加启动仪式并致辞。本次发布会以“融媒聚势,智造未来”为主题,双方将依托各自在内容、技术、资源等层面的强力优势,开展关于内容生产、分发与内容生态布局等多层次的战略合作,全面打通百家号与北京日报的资源、技术、内容优势环路,构建本地优质内容生态。<a href=\"https://baidu.com\">标签内的链接会被过滤,文本会保留。</a><br/><img src=\"https://qiniu.pcfast.org/wp-content/uploads/2018/12/2018122110084757.jpeg\" alt=\"签约\" /></p><p>北京日报拥有强大的采编能力和雄厚的地方媒体资源,是雄踞本地内容生产端的头部力量,而百家号作为百度内容生态的战略产品,信息流正是双方内容生态的天然连接器,二者的战略联手势必加速传统媒体与内容分发平台的充分融合,赋能信息资讯精准化、个性化和多元化的传播。<b>本句也会加粗:北京日报社党组副书记也在发言中谈到,百家号与北京日报的联合,将百度的先进技术基因注入党媒,实现多介质多渠道的立体传播,一定能够让北京声音在网络上传得更开更广。</b></p>这里是视频(每篇文章只支持发布一篇视频):<video src=\"http://baijiahao.baidu.com/1561213.mp4\" poster=\"https://http://baijiahao.baidu.com/1561213.png\"/>这里是音频(每篇文章只支持发布一篇音频): <audio src=\"http://baijiahao.baidu.com/1561213.mp3\" title=\"1561213\"/>"
      }

4.7 返回值示例

          {
              errno : 0,
              errmsg : "",
              data : {
                  article_id : 文章对应标示(string类型)
              }
          }
      

5. 发布图集

5.1 接入流程

账号状态:发布图集内容的百家号账号状态正常

获取授权:同意开发者使用规范,获取app_token

创建文章:创建图集内容

调用接口:调用发布图集内容接口

5.2 接口地址

URL:http://baijiahao.baidu.com/builderinner/open/resource/article/gallery

5.3 接口参数

参数名称类型是否必需描述
app_idstring作者账号ID
app_tokenstring授权密钥
titlestring图集标题,限定8-40个中英文字符以内
photographjson至少6张图片,desc描述为0-200个汉字;不支持GIF格式图片,发布GIF图将会被退回,且占用发文篇数;封面图尺寸不小于400*224;宽高比在0.5-2之间
origin_urlstring图集资源原地址url
publish_timeint原文发布时间,时间戳

5.4 注意

为了避免文章重复同步,百家号会做去重策略,相同文章禁止重复提交

5.5 返回值及解释

返回值类型描述
errnoint错误码
errmsgstring错误信息
dataarray返回数据

5.6 发布图集示例

          {
              "app_id" : "INPUT_ID_HERE",
              "app_token" : "INPUT_TOKEN_HERE",
              "title" : "百家号与北京日报联手,打响省级媒体战略合作第一枪",
              "origin_url" : "http://baijiahao.baidu.com/s?id=15657073680049221",
              "publish_time" : 1493174908,
              "photograph" : "[{\"src\":\"https://pic.rmb.bdstatic.com/0a9d9bb7c79f1d884a1e3f2cf67840d9.jpeg\",\"desc\":\"百家号与北京日报联手,打响省级媒体战略合作第一枪\"},{\"src\":\"https://pic.rmb.bdstatic.com/a7b60cf66811e27d7f7466f88ba176e5.jpeg\",\"desc\":\"百家号与北京日报联手,打响省级媒体战略合作第一枪\"},{\"src\":\"https://pic.rmb.bdstatic.com/9be6b6a7aa6d77782e55451d3b5e2e05.jpeg\",\"desc\":\"百家号与北京日报联手,打响省级媒体战略合作第一枪\"},{\"src\":\"https://pic.rmb.bdstatic.com/0a9d9bb7c79f1d884a1e3f2cf67840d9.jpeg\",\"desc\":\"百家号与北京日报联手,打响省级媒体战略合作第一枪\"},{\"src\":\"https://pic.rmb.bdstatic.com/a7b60cf66811e27d7f7466f88ba176e5.jpeg\",\"desc\":\"百家号与北京日报联手\"},{\"src\":\"https://pic.rmb.bdstatic.com/9be6b6a7aa6d77782e55451d3b5e2e05.jpeg\",\"desc\":\"百家号与北京日报联手\"}]"
          }
  
      

5.7 返回值示例

          {
              errno : 0,
              errmsg : "",
              data : {
                  article_id : 文章对应标示(string类型)
              }
          }

6. 发布视频

6.1 接入流程

  • 账号状态:发布视频内容的百家号账号状态正常
  • 获取授权:同意开发者使用规范,获取app_token
  • 创建文章:创建视频内容
  • 调用接口:调用发布视频内容接口

6.2 接口地址

URL:http://baijiahao.baidu.com/builderinner/open/resource/video/publish

6.3 接口参数

参数名称类型是否必需描述
app_idstring作者帐号ID
app_tokenstring授权密钥
titlestring视频标题,限定 8-40 个中英文字符以内
video_urlstring视频原地址,目前支持 mp4 等,不支持 m3u8
cover_imagesstring视频封面图片地址 url, 目前只支持 1 张图片作为封面,封面图尺寸不小于660*370
is_originalint标定是否原创,1 为原创,0 为非原创
use_auto_coverint是否使用自动封面,1为使用自动封面,其余为不使用自动封面
tagstring视频tag,tag之间以半角英文逗号分割,每个tag长度不超过10个字符,最多支持10个tag

格式说明:目前仅支持MP4、MOV、MKV、AVI、FLV、MPEG、OGG、VOB、WEBM、WMV、RMVB格式

6.4 注意

为了避免文章重复同步,百家号会做去重策略,相同文章禁止重复提交

6.5 返回值及解释

返回值类型描述
errnoint错误码
errmsgstring错误信息
dataarray返回数据

6.6 发布视频示例

{
              "app_id" : "INPUT_ID_HERE",
              "app_token" : "INPUT_TOKEN_HERE",
              "title" : "百家号与北京日报联手,打响省级媒体战略合作第一枪",
              "video_url" : "http://baijiahao.baidu.com/1561213.mp4",
              "cover_images" : "https://pic.rmb.bdstatic.com/0a9d9bb7c79f1d884a1e3f2cf67840d9.jpeg",
              "is_original" : 1,
              "tag" : "百家号,北京日报,媒体",
              "use_auto_cover" : 1
          }

6.7 返回值示例

 {
              errno : 0,
              errmsg : "",
              data : {
                  article_id : 文章对应标示(string类型)
              }
          }

7. 撤回内容

7.1 撤回内容API介绍

撤回API可对作者已发布的内容进行撤回,撤回后的文章将不再展示。

7.2 撤回流程

账号状态:发布内容的百家号账号状态正常

获取授权:同意开发者使用规范,获取app_token

文章状态:需要撤回的文章为作者已发布的文章,且状态为“已发布”

调用接口:调用撤回API接口

7.3 撤回接口地址

URL:http://baijiahao.baidu.com/builderinner/open/resource/article/withdraw

7.4 接口参数

参数名称类型是否必需描述
app_idstring作者账号ID
app_tokenstring授权密钥
article_idstring需要撤回的文章ID

7.5 返回值及解释

返回值类型描述
errnoint错误码
errmsgstring错误信息
dataarray返回数据

7.6 撤回内容示例

          {
              "app_id" : "INPUT_ID_HERE",
              "app_token" : "INPUT_TOKEN_HERE",
              "article_id" : "INPUT_ARTICLE_ID_HERE"
          }
      

7.7 返回值示例

          {
              errno : 0,
              errmsg : "",
              data : {
                  article_id : 文章对应标示(string类型)
              }
          }
      

8. 修改图文

8.1 修改图文API介绍

修改API可对已撤回的图文进行修改,可修改标题、内容和封面图,修改成功后的文章将再次发布。对草稿状态的文章调用此API时,将会直接发布。

8.2 修改前提

  1. 需要修改的文章状态为“已撤回”
  2. 发布草稿时将占用当天发文次数
  3. 目前只能针对图文内容进行修改

8.3 修改流程

  1. 账号状态:发布内容的百家号账号状态正常
  2. 获取授权:同意开发者使用规范,获取app_token
  3. 文章状态:需要修改的文章已经撤回,状态为“已撤回”
  4. 调用接口:调用修改API接口

8.4 修改接口地址

URL:http://baijiahao.baidu.com/builderinner/open/resource/article/republish

8.5 接口参数

参数名称类型是否必需描述
app_idstring作者账号ID
app_tokenstring授权密钥
titlestring文章标题,限定8-40个中英文字符以内
contentstring正文内容,限制20000个中英文字符内,富文本
cover_imagesjson文章封面图片地址url, 0-3张封面图,可以为空,没有封面图的内容将会进入草稿
article_idstring需要修改的文章ID
origin_urlstring原文地址

8.6 返回值及解释

返回值类型描述
errnoint错误码
errmsgstring错误信息
dataarray返回数据

8.7 修改图文示例

          {
              "app_id": "INPUT_ID_HERE",
              "app_token": "INPUT_TOKEN_HERE",
              "title": "北京日报联合百家号,内容、技术相互赋能",
              "origin_url": "http://baijiahao.baidu.com/s?id=1565707368004927",
              "article_id" : "INPUT_ARTICLE_ID_HERE",
              "cover_images": "[{\"src\":\"https://pic.rmb.bdstatic.com/0a9d9bb7c79f1d884a1e3f2cf67840d9.jpeg\"},{\"src\":\"https://pic.rmb.bdstatic.com/0a9d9bb7c79f1d884a1e3f2cf67840d9.jpeg\"},{\"src\":\"https://pic.rmb.bdstatic.com/0a9d9bb7c79f1d884a1e3f2cf67840d9.jpeg\"}]",
              "content": "<div class=\"p-text\" style=\"margin: 0px;\"><p style=\"margin: 0px;\">北京日报社党组副书记也在发言中谈到,百家号与北京日报的联合,将百度的先进技术基因注入党媒,实现多介质多渠道的立体传播,一定能够让北京声音在网络上传得更开更广。<br></p></div>"
          }

8.8 返回值示例

          {
              errno : 0,
              errmsg : "",
              data : {
                  article_id : 文章对应标示(string类型)
              }
          }
      

9. 错误码说明

errno说明
0成功
2参数错误
4数据库错误
5数据库错误
60000005账号未审核通过或在禁言期
60000006百家号内部服务异常
60000009账号不存在
60001001授权校验失败
60001003撤回或修改时文章状态错误
60001008当天发文篇数校验失败
60001009当天剩余发文篇数为0
60000020百家号内部服务异常

10. 更新日志

2018-12-21
百家号开放了内容发布、撤回及修改的API接口。开发者可以实现内容自主接入。

Last modification:March 19th, 2019 at 01:17 pm

Leave a Comment