坚信科学,分享技术

2018全新版本,未来在blog.54chen.com更新博客!

>>>尝试更加利于阅读的2014版科学院,以后都在新版上写。

Tag Archives: api

移动互联网api设计实践

过去一年时间里,都在做中国移动互联网下的API设计工作,所面对的情况可能是最具中国特色的了。如果你在尝试构架一整套的新的API供你的客户端使用,可以尝试以下的几点: 1)api所使用协议,要能够不怕被加js、加广告和各种代码。 全国各地的运营商,有习惯挂广告、加代码等等,要做的事情就是在客户端做各种解析判断。实践证明,这帮孙子的设备是检测http协议的head头里的content-type,如果是html/text则会加,如果是text/json就不加了,所以,你懂的。 2)api可视化 你的app上架了,后端也布好了。然后呢,就天天看下载量。但后端好坏一问三不知。所以在设计api时,要提前回答以下问题: 1.此时此刻,有多少个app正在调用这些api,每分钟多少个? 2.他们(api)有快? 3.能否很简单地通过浏览器快速debug? 4.能否快速禁止单个用户? 3)链路 在幅员辽阔的我国,总是一个地方到一个地方的IDC直接就ping不通(移动互联网下更甚)。于是需要花钱自己打通这些地方,没有专线,只有代理再代理。 4)api quota与perfcounter 对api进行quota限制,针对每个api每个人,都有限额。 这个限制的传统做法: 1.每天的上限调用次数。每天半夜清空,一天一个量累计。 2.每分钟的频度。这个防止有恶性的突发情况。 上述二者,缺一不可。 perfcounter用于对api的监控设计指标,如果一个api有异常,应当十分灵敏地得出结论,而不是误报连连。

Continue reading

Posted in WEB相关 | Tagged | 3 Comments

twitter api 中文文档 [前言][515更新]

[ 翻译:陈臻 本文版本:v1.1 最后修改:2009.5.15 转载请注明原文链接:http://www.54chen.com/c/591 原稿:twitter wiki 完成2%] 前言 (每个开发者在开始使用api前都必须知道的概念) 开始使用api前必读 (细读这一节,你将掌握大多数经验丰富的开发者知识) 【不知道为什么,这一节的内容在wiki里被人删除了】 每一个开发者都必须知道的事情 (每个twitter api开发者都必须知道的基础知识) 0)FAQ的内容 当你开始开发的时候,熟悉FAQ的内容并且知道问题所在。 1)twitter其实有两份api 目前twitter api存在两个分立的版本。大部分的开发者都混用这两份api来完成开发。将REST和Search的api分离是不理想的,完全是由于历史原因。如果开发周期允许的话,我们打算合并REST和Search的api完善之。api预览里的前言部分说明了这段历史。 2)你不能无限次地调用 api的使用频率是有限制的。你可以阅读《我们有个雷管》(这个名字好雷哦)来学习下。 3)此api是完全基于HTTP的 从twitter api检索数据的方法需要发送GET请求。提交、修改或者删除数据使用POST请求。DELETE请求也是可用来删除数据。如果你没有使用正确的方法请求数据,使用特殊HTTP方法的api就返回一个错误。HTTP的返回(有链接)是丰富多彩的。 4)此api是RESTful的源 twitter api企图确保按照REST的原则来设计。只需要简单修改你请求的扩展上的格式就可以取到你所指定的格式。本文档指明了对每

Continue reading

Posted in 架构研究, 资料文档 | Tagged , , | 10 Comments