嘀咕开放的API文档
2009-02-20 10:00
digu通过API的方式开放一些应用接口,这篇文档用来介绍digu目前开放的接口,为希望开发与digu互通信工具的开发人员提供技术和文档服务。
认证
除了公共时间线外(public timeline),所有的API方法都需要进行用户认证, 所有的返回都于认证用户相关。例如,尝试获取一个设置为私密的且不是您的好友的用户信息时,将会返回失败状态。
digu目前仅支持HTTP Basic Authentication认证协议。当进行Basic Auth,请使用您在digu注册的用户名做为username部分,记录在Session或Cookie里的用户信息。
多状态[RESTFull]结果传输
diguAPI力求根据用户的请求返回特定格式的数据,你可以发现我们提供的API中有一个重要的便利之处,通过简单的更改URI中的文件后缀名,您可以获得您想要的返回结果的格式,这篇文档中将说明每个方法中有哪些格式可以用。
digu目前支持以下的三种数据返回格式:XML、JSON、RSS、 Atom,你可以在每次请求时根据请求的方法指定被支持的其中一种结果。
参数
一些API接受可选和必须的参数,当可用时,我们会在接下来的文档中提到这些参数。主意:当传送复杂字串时,请一定先将字串编码为UTF8格式,并再做一次Url Encode编码。
HTTP请求
除非特意指明,digu的API开放通过HTTP GET方式的请求,需要提交信息或传送私密消息的请求应用POST方法。
以下将说明,一些API方法将返回基于用户请求内容相关的信息,而有一些将返回同 客户端发送的HTTP头信息相关的一些信息。例如,多数支持since参数的方法,同样会对HTTP头中的If-Modified-Since这个Tag 感兴趣。需要主意的是,当某些行为即可以通过参数又可以通过HTTP头进行控制时,优先接受通过参数方式设定的值。
当请求返回数据时,返回数据的编码统一为UTF-8格式,且我们会将一些外部符号编码为HTML实体(&#number; 或&text)格式。
HTTP状态码
Digu API将为每次请求返回合适的HTTP状态码。例如,当请求一个不存在的用户信息时,我们会返回404 Not Found;当一次请求没有被认证并授权时,我们会返回401 Not Authorized状态。
玩转diguAPI的简便方法
如果您的系统安装有 curl (多数*nix系统应该会有),您已经有了一个非常强大的玩儿digu API的工具。以下是使用curl的例子,非常简单哦:
* 非授权情况下访问public_timeline:curl doc.guandang.net
* 获取朋友的timeline, 使用认证: curl -u email:password doc.guandang.net
* 仅获取头部信息: curl --head email:password doc.guandang.net
用户digu状态相关方法
public_timeline [可用
在线互动式文档分享平台,在这里,您可以和千万网友分享自己手中的文档,全文阅读其他用户的文档,同时,也可以利用分享文档获取的积分下载文档
常见开放的 API 文档资源所谓的开放 API(OpenAPI)是服务型网站常见的一种应用,...api/api.jsp 嘀咕 API - http://code.google.com/p/digu-api/wiki/DiguApi...
嘀咕网API说明文档beta0... 11页 免费喜欢此文档的还喜欢 开心网开放API说明...开心网开放 API 说明文档 V1.2 2011-02-23 开心网开放 API 说明文档开放 ...
嘀咕网API说明文档beta0.9_IT/计算机_专业资料。嘀咕网API嘀咕开放的 API 文档 2009-02-20 10:00 digu 通过 API 的方式开放一些应用接口,这篇文档用来介绍 ...
在线互动式文档分享平台,在这里,您可以和千万网友分享自己手中的文档,全文阅读其他用户的文档,同时,也可以利用分享文档获取的积分下载文档
互联网常见 Open API 文档资源所谓的开放 API(OpenAPI)是服务型网站常见的一...api/api.jsp 嘀咕 API - http://code.google.com/p/digu-api/wiki/DiguApi...
在线互动式文档分享平台,在这里,您可以和千万网友分享自己手中的文档,全文阅读其他用户的文档,同时,也可以利用分享文档获取的积分下载文档
在线互动式文档分享平台,在这里,您可以和千万网友分享自己手中的文档,全文阅读其他用户的文档,同时,也可以利用分享文档获取的积分下载文档
在线互动式文档分享平台,在这里,您可以和千万网友分享自己手中的文档,全文阅读其他用户的文档,同时,也可以利用分享文档获取的积分下载文档
互联网常见 Open API 文档资源所谓的开放 API(OpenAPI)是服务型网站常见的一...api/api.jsp 嘀咕 API - http://code.google.com/p/digu-api/wiki/DiguApi...
热门文档