最新土豆mini接入文档.doc

土豆mini接入文档
目录
土豆mini接入文档 1
(一) 服务描述: 1
(二) 接口描述: 1
(三) 数据格式 2
服务描述:
土豆得合作商需要自己定义mini中得数据内容,需要自准备mini数据,然后通过网站自动的将数据发送到土豆的系统中.
接口描述:
该服务功能,土豆网提供了两种接入方式,一种是接入商提供接口,由土豆网提供,第二种是土豆网提供,由接入商调用.
tudou网提供的http接口
request:
:http://tudoumini./tudoumini/client/
(接入方需要以post方式调用该接口.)
:
Data(必填):xml组织的数据
response:
返回xml格式的数据,表示成功或者失败
Eg: <result><type>ess</type><msg>no</msg></result>
或者: <result><type>failure</type><msg>you have not auth</msg></result>
附注:
该接口由土豆网的合作商调用,调用之前,土豆网会分配接口使用帐号给合作商.
接入方提供http接口
Request:
:i/client/
:无
Response:
返回数据:返回xml格式的数据(数据格式),表示需要放到mini中的数据值.
附注:
该接口由土豆网调用,调用之前合作商应该分配帐号给土豆网.
土豆提供的请求模板接口
Request:
1请求url:http://tudoumin./tudoumin/template/1/
2 请求参数包含在url中,.
如果请求参数是all,则表示请求所有模板.
Response:
返回数据是模板列表
//TODO 模板列表的数据格式
数据格式
描述:
土豆mini中的数据主要设计成插件机制,
,比如多个图片,或者多个文字链接,那么图片和文字连接都是资源,每个插件在定义的时候,就已经决定了其包含的资源.
数据示例:
接入方需要做的是根据土豆网提供的插件来提供对应格式的数据.
<plugin>
<pluginTemplateId>由土豆提供的插件号(土豆将会提供多种模板供接入商选择)</pluginTemplateId>
<description>插件实例描述</description>
<beginDate>开始日期</beginDate>
<endDate>结束</endDate>
<list>
<!—list 节点的数据有可能是多个,这个由插件模板的定义来决定-->
<resourc