动态接口手册.doc

《动态接口手册.doc》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、动态接口手册目录1修订记录12介绍12.1目的和范围12.2术语与缩写解释23访问说明23.1采用Http或Https访问23.2访问路径23.3编码规则23.4系统级参数23.4返回码定义34接口定义34.1发送动态信息34.1.1描述34.1.2请求地址44.1.3参数说明41修订记录修订时间版本号内容摘要修订人2011-01-27V1.0编写文档吴炤鉴2介绍2.1目的和范围本文档作为Web端提供给第三方接口开发的依据。2.2术语与缩写解释编号术语解释1domain统一访问域名，os.api.cnfol.com3访问说明3.1采用Http或Https

2、访问采用http或https访问，提供POST方式。POST发送动态GET获取动态信息（暂不提供）3.2访问路径统一访问路径：http://os.api.cnfol.com/social/rest/feed/3.3编码规则统一采用UTF-8编码3.4系统级参数参数名类型是否必须描述oauth_versionfloat是oauth规范的版本oauth_noncelong是oauthnonce值oauth_signature_methodString是oauth签名算法，当前仅支持HMAC-SHA1oauth_consumer_keyString是发布给开发

3、者的公钥（ApiKey）xoauth_requestor_idLong是请求者IDoauth_timestampString是Oauth时间戳oauth_signatureString是根据请求参数用用户的SecretKey加密的签名信息stString是从应用容器获取的SecurityToken，用于校验用户登录信息备注：st和oauth认证可以二选一，st是平台传给应用的参数，可以使用$_GET[‘st’]获取到3.4返回码定义返回代码说明200成功返回成功或失败，统一体现在header头部的状态。200表示请求成功，其他表示错误4接口定义4.1发送

4、动态信息4.1.1描述4.1.1.1发送动态条数限制1、一个应用一个用户每天最多发送10条4.1.1.2动态模板参数限制新鲜事包含模板标题和模板内容两部分，这两部分都可以包含自定义的模板参数(简称token)。发送新鲜事时，标题和内容数据分别是一个JSON对象，指明了模板中定义的token被替换成什么值。JSON数据中的"images"是保留token，表示新鲜事中包含的图片信息（图片src和图片链接），不能用来定义成其它含义。如：4.1.2请求地址http://os.api.cnfol.com/social/rest/feed/4.1.3参数说明4.1

5、.3.1业务级参数参数说明templateId模板ID，在开发者中为你的app点击“编辑Feed模板”，可以创建新的新鲜事模板，并获取到模板IDtemplateParamsJSON对象，用来替换新鲜事模板中的一些自定义{}参数。4.1.3.2返回参数参数说明DynamicID发送成功后的动态ID5实例文件config.php代码：

6、=平台传给应用的st参数?>文件lib.class.php代码：

7、RLOPT_CUSTOMREQUEST,$method);curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);curl_setopt($ch,CURLOPT_FOLLOWLOCATION,1);curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,false);$data=@curl_exec($ch);$http_code=curl_getinfo($ch,CURLINFO_HTTP_CODE);@curl_close($ch);if($http_code==200){//成功echo'成功

8、';}else{//失败echo'失败';}echo'

';print_