首页 > 帮助文档首页 > 网站接入 > 入门指南

入门指南

目录

应用接入基本流程图

应用的开发、接入及发布的基本流程如下图所示,开发者可以根据应用当前的状态进行相应的操作:

01.png

注册成为开发者

在您初次使用百度连接开放平台之前,您需要通过我们的开发者后台注册成为百度连接开放平台的开发者。如果您之前已经注册成为百度应用开放平台的开发者,那恭喜您,您也已经是百度连接开放平台的开发者,无需再额外注册一次O(∩_∩)O~

创建应用

激活开发者账号后,进入百度开发者中心的开发者后台,点击导航条右侧的创建应用链接,进入如下应用创建页面:

02.jpg

选择合作网站

  1. 填写网站名称(最多32个字符,网站名称后面还可以修改)
  2. 填写网站地址(例如:http://example.com 或 https://example.com,网站地址必须以http://或https://开头)
  3. 将验证文件放到该网站的根目录下,以确定该网站的真实性


验证没问题,点击“创建”按钮,平台将为该应用分配一个全局唯一的应用ID和API Key以及与API Key配对使用的Secret Key,并进入应用基本信息填写页面。应用名称一定要与您的应用比较贴切,避免取一个过泛的名称,对于合作网站,例如,有些合作网站所填写的应用名称叫“XX一号通”,这都是很不好的,一般难以被成功对接。

编辑应用信息

应用详细描述

应用创建成功后,系统将引导您进入应用详细描述填写页面。

07.jpg

应用设置

完成应用详细描述后,保存进入下一步进行应用设置。应用设置中主要是该合作网站投放渠道(如果不打算投放渠道,开发者可以跳过应用设置)。目前有两个渠道:

  • 开放平台首页

选择开放平台首页渠道,会展示如下填写信息:

09.jpg
细分通知信息:细分通知信息可以有多组,比如你可以推送“短消息”、“评论”、“@我”等多种类型的消息数据。每一组细分通知信息都需要两个配置:
  • 细分通知展示名:消息名称,比如“短消息”、“评论”或者“@我”。此处不要带量词,比如:条、个、支等。
  • 细分通知对应页面URL:当用户点击相应的消息链接后跳向的地址。
例如:
细分通知展示名1: @我
细分通知对应页面URL1:http://some_url/method.php
通知信息描述: 用于提示用户网站能提供的通知提醒类型。
发起绑定url:在百度将以此url携带参数访问第三方,实现一号直达功能。不超过255个字符。
可绑定url列表:首页导航模块中出现列表中的url,将提示用户与百度连接。使用 | 分隔。不超过2000个字符。


  • 浏览器

选择浏览器渠道,只需勾上即可。

08.jpg

上传应用相关图片

完成应用类型相关信息设置,点保存后,系统将进入应用相关图片上传页面,如下图示:

10.jpg

应用相关图片目前是指以下3种图片:

  • 应用icon

应用icon图将会在连接开放平台的应用广场页面中显示(暂未开放),其规格要求为16px*16px,jpg或gif格式,应用提交前必须上传,对于合作网站,建议用网站favor图

  • 应用logo

应用logo图被展现的地方很多,如各种应用列表页、应用授权页面等,其规格要求为64px*64px,jpg或gif格式,应用提交前必须上传,对于合作网站,建议用网站logo图

  • 应用介绍图

应用介绍图会在应用详情页面被展现,一般是对应用使用过程中的截图,以便用户在使用您的应用之前就可以大致了解应用的主要功能,最多可以上传4张,其规格要求为480px*360px,jpg或gif格式。

应用安全设置

完成应用相关图片上传,点保存后,系统将进入应用安全设置页面,如下图示:

11.jpg
  • 根域名绑定

如果您的应用包含多个域名下的页面,可以将应用的根域名或所有子域名列表填写在这里,以半角逗号隔开,域名列表会在用户登录授权应用时用到。例如,您的应用既有a.example.com域下页面,也有b.example.com域下页面,则这里可以填写example.com,或a.example.com,b.example.com

  • 授权回调页

这个是设置OAuth授权服务中的回调地址。即参数“redirect_uri”的值。详见Authentication CodeImplicit Grant授权方式

  • 重置密钥

重置密钥功能是防止密钥丢失,重新生成新的密钥。

  • 应用服务器IP地址

如果您的应用会在服务端发起对百度Open API接口的调用,建议将您的服务器公网IP列表填写在这里,以提高通信安全性。第三方最多可以填写15个IP,IP之间以半角逗号隔开,每个IP还可以采用202.205.11.*或202.205.11.1*格式进行通配,但如果您的公网IP不多于15个,则建议不要使用通配符,随意扩大授权范围将无法保证通信的安全性。

应用提交

完成应用安全设置操作后,会进入如下图所示的页面中对应用提交或者直接点击左边的基本信息

18.png

注意:该示例图是在应用设置中选择了浏览器渠道。如果开发者自己不想投放任何渠道,则不会有应用提交的提示。应用的对接只针对选择了渠道的应用而言。

提交之后,请耐心等待,我们会在1周内对其进行对接并通过邮件和站内消息的方式通知对接结果给开发者。在等待对接的过程中,如果开发者还需要重新修改应用信息,则可以先取消对接,然后再在修改完成后重新提交。对于已成功对接的应用,开发者如果对应用信息作了任何更新,也需要重新提交,否则更新的内容是不会生效到线上的。

另外,开发者也可以通过访问我的应用页面来查看自己的各个应用的当前状态。