申请和配置应用
目录 |
[编辑] 申请一个应用（App）
在开放平台的技术架构中，一个人人Connect站点也相当于一个人人网应用（App），所以在开发之前你需要申请创建一个应用，从而获得一个新的API Key，这个API Key用于唯一标识你的Connect站点。我们不建议利用一个API Key同时开发Connect和站内Canvas应用。
下面我们通过截图的方式详细说明申请App的步骤。
- 首先进入“开发中心”http://dev.renren.com/ 。应用和Connect站点的创建和配置都在这里完成。
- 点击“创建新应用”。如下图：
- 如果已创建过应用，再创建一个应用，点击“创建新应用”。如下图：
- 输入网站名称，勾选许可协议，然后点击“保存设置”。如下图：
- 获得API Key和Secret。在教程的其余部分，我们将使用“游向彼岸”这个Demo站点的API Key进行代码举例，在你的开发中，请务必替换成你申请到的API Key。Secret是开放平台和你的站点秘密约定的一个Key，用于双方做一些安全性的验证，请注意严格保密，并保证只在你的站点服务端代码中使用此值，而不要将此值用在Client端代码中，以防泄露。如下图：
[编辑] 更新基本配置
创建了一个应用并取得了API Key之后，需要填写一些基本的配置信息。下面介绍的“基本配置”对于Connect站点和站内应用都适用。
- 更新应用Logo。
点击左上角“更新Logo”，如下图：
然后根据提示上传75*75的图片作为“应用Logo”。
“应用Logo”主要用于该站内应用或Connect站点在人人网“应用列表页”的展现中。详情请参考Connect站点在人人网的展现方式。
- 填写应用基本信息。
点击“编辑应用属性”，在“基本信息”这个Tab中认真填写和配置“应用简介”、“应用图标”等信息。如下图：
在“运营信息”这个Tab中认真填写“联系电话”、“开发者Email”、“客服电话”、“客服Email”等信息。如下图：
“应用简介”-- 显示在人人网的应用列表页面，是关于该应用的简单描述。这个描述是人人网用户在第一次看到你的站点时所展示的文字，可能是人人网用户对于你的站点的第一印象，所以这里填写的信息应该尽量生动形象，更吸引人。
“应用图标”-- 这个图标会出现在应用所有相关的页面中，例如用户的应用菜单、新鲜事等。图片大小是16*16。
“联系电话”-- 开放平台用来及时联系开发者的联系电话。请如实填写。
“开发者Email” -- 开放平台将会使用此Email联系开发者。请如实填写。
“客服电话” -- 用户用来及时联系开发者的客户电话。请如实填写。
“客服Email” -- 用户将会使用此Email联系开发者。请如实填写。
更多详情请参考Connect站点在人人网的展现方式。
- 填写授权设置。
选择“授权设置”这个Tab，填写“授权回调地址”和“移除后回调地址”。
“授权回调地址”-- 当用户连接了你的站点或授权了你的应用后，开放平台会回调这个地址通知应用。参见Post-Authorize_URL。在这个教程中我们暂时不需要这个值，先略过不填。
“移除后回调地址”-- 当用户删除你的应用后，开放平台会回调这个地址通知应用，应用需删除存储的用户相关数据。参见Post-Remove_URL。对于建立了帐号关联的Connect站点，还需要解除人人Connect帐号关联。在这个教程中，我们假设你的站点的域名是www.swimmingacross.com，可以将这个“移除后回调地址”填为“http://www.swimmingacross.com/remove.do”，来处理Connect用户在人人网上删除应用的情况，这个地址在后面的教程中会用到。
[编辑] 更新Connect配置
下面介绍的“Connect配置”对于Connect站点是必须要设置的，对于想使用自定义新鲜事等JavaScript Client功能的也需要设置。
选择“Connect设置”这个Tab来进行设置。如下图：
- 设置Connect URL。
这是你的Connect站点的入口地址，Connect站点在人人网上的入口（如列表页、新鲜事、菜单等）一般都是指向这个地址。一般情况下，这个地址指向的页面需要包含Connect登录按钮，以方便Connect用户快速流畅的登录。例如，“蚂蜂窝”将这个URL填为“http://www.mafengwo.cn/s/login.html”。
假设我们在“游向彼岸”的首页上放置了Connect登录按钮，那么我们可以选择将此项填成首页地址，即http://www.swimmingacross.com/index.html。
- 上传Connect Logo。
由于登陆页面改造，暂时没用到，可以不传，目前的登录页面如下图所示：
- 上传Connect连接新鲜事图片。
该图片出现在用户“连接新鲜事”中，大小为100*100。
“连接新鲜事”是当某个用户第一次连接你的站点时发送出来的，该用户的好友可以看到。这个新鲜事不需要Connect站点的开发者做任何开发工作，只要该站点通过审核，就会在用户首次连接时自动发送“连接新鲜事”（注意处于未审核状态的站点暂时不会发送此类新鲜事，以免在正式开发完成之前造成不必要的传播）。用户在连接时也可以选择不发送“连接新鲜事”。
下面是一个连接新鲜事的截图：
- 设置根域名（Base Domain）。
接入人人Connect的第三方站点的所有子域名的公共基础根域名。如果你的站点由多个子域名组成，请务必填写此项。
注意：此项在OAuth2.0认证与授权过程中也将使用。在OAuth2.0认证与授权过程中的“redirect_uri”所在的域，必须为该根域名的子域。
例如，在“游向彼岸”中此项可以填写为“swimmingacross.com”。
将上述所有设置填好之后，点击“保存”。