技术开发指南

出自天涯开放平台资源

在2012年2月29日 (三) 03:58由Tyopen (讨论 | 贡献)所做的修订版本
(差异) ←上一修订 | 最新修订 (差异) | 下一修订→ (差异)
跳转到: 导航, 搜索

目录

概述

API平台应用日益丰富,为了让开发者更容易了解开发流程;
为了规范API的接口,需要制定开发规范;
为了对开发者进行一些深层次的指导,特此制定技术开发指南;

开发流程

申请APPKEY

访问http://open.tianya.cn
1. 需要激活开发者身份;
2. 登录后进入—》我的开发,然后“创建应用”;
3. 创建完成后会生成对应的appkey,app_secret,记住:您的app_key是应用的唯一标识,千万别对外泄露;

应用创建及发布流程

应用的创建及发布包括下面的流程,开发者可以根据应用当前的状态进行相应的操作; basicflow.jpg

开发指南

SDK简介及作用

SDK是特定语言实现的一个可以通用的API使用的工具,SDK实现了天涯社区开放平台的全部或大部分接口,以便开发者不用关心API接口细节,认证实现等,可以直接调用接口完成特定的功能。支持天涯社区开放平台接口的SDK语言包括php,java,PythonSDK,具体请参考SDK列表页面。

如何通过授权访问数据

目前天涯开放平台对外支持OAUTH认证。

OAUTH认证

OAUTH协议为用户资源的授权提供了一个安全的、开放而又简易的标准。
OAuth是一种国际通用的授权方式, OAuth的官方技术说明可参看 http://oauth.net/2 (英文)。
使用OAUTH认证来获取天涯数据介绍详细见:Oauth相关说明

接口数据如何适当的缓存

在你的应用中,正常业务需要的情况下,尽量减少请求量,减少请求接口返回数据,有必要缓存一些已经获取到的数据,来提高应用的效率和体验。下面一些场景,可供参考:

获取weibo/gethomeline(获取我的微薄主页关注者微薄列表)
1. 第一次请求后,缓存下请求内容。
2. 下一次刷新的时候使用page,pagesize(值为前一次请求的最大微博page)来获取更新。

获取socialgraph/getfans (获得当前用户的粉丝列表)
1. 第一次请求后,缓存下请求内容。
2. 当获取socialgraph/getfans 接口有新粉丝的时候,则重新获取,没有则不需要获取。
3. 完成后调用socialgraph/getfans 来清除消息提醒

如何避免rate limit

天涯开放平台会对每个应用的用户有一个频率限制,怎样来让用户的操作不达到频率限制呢?下面有一个简单的样例,参考下:

1. 确定哪些需要定时访问的接口,每个接口做一个优先级,访问的频率做为一个变量。
2. 计算下一定要访问的接口数据量。
3. 预留给用户一定的更新(发微博,私信等)。
4. 使用user/limitstatus查看当前appkey所能支持的每小时的最大访问量,根据此访问量来确定频率的值。

API调用权限

1.针对一个APP每小时请求次数限制:
通过审核的:600次/分钟。
未通过审核的:100次/分钟。

2. API调用次数不够用怎么办?
后台查看相关数据的真实性,可以给予特别的频率限制

3.微博接口二次限制:
1分钟内最多6条
15分钟内没有
1小时内没有
24小时内最多140条
注:其他API暂时不受这个限制。

技术咨询和建议

1、天涯开放平台技术论坛
2、@天涯开放平台
3、Email: openapi@tianya.cn

查看
个人工具
成功案例
帮助中心