生接口v2.平台数据

1、CmsTop端数据交互规范思拓合众科技目录目录2草稿 正式发布 正在修改文档标识cmstop / mobile当前版本V1.0修改日期2013-01-21数据交互说明1数据接口说明3尺寸定义8834 服务端配置881数据交互说明使用HTTP 协议进行数据通信；客户端使用GET 或T 方式发送请求；服务器端使用JSON 格式返回数据；所有数据属性名称定义均使用小写表示；所有列表类接口中均由一个time 字段（时间戳）用来标识上次获取数据的时间，下次获取数据时作为参数传递获取较新的内容，同时返回一个新的 time 值，如果 time 为 0，则忽略该值。所有接口均有一个type 字段,用来标识请求

2、的来源.type 是 String 类型,包括如下值(全字母小写)1.1 错误信息规范服务端返回的数据总是包含se 字段。当se 值为true 时接口调用成功，返回类似如下结构数据：其中message 为成功提示信息（可选），data 为数据，不同接口返回的具体数据不同，请以接口返回数据为准，这里仅做示例说明。当se 值为false 时接口调用失败，返回如下结构数据：se: false,message: this is the error messagese: true,message: this is the sucdata: s message,mobile版(默认)ipadipad 客户

3、端pad其他pad 客户端其中error 属性为错误信息。发生错误时的返回格式总是如此，请从error 中获取具体的错误。1.2 接口以下接口中以代替接口进行书写；地址返回数据均指请求成功时返回的正常数据，请求出错时请参考“错误信息规范”；数据接口说明会员会员使用接口（客户端二期用户交互接口文档，以下简称“接口”，2.2用户接口）的返回值进行。接口地址：?app=mobile&controller=member&action=register接受参数：返回数据：se : true,data : userid : 1, username : cmstop, : HYPERLINK mailto:

4、webmastercmstop.dev webmast HYPERLINK mailto:webmastercmstop.dev ercmstop.dev,avatar : ,参数方法名称备注usernameT用户名必选，使用“接口”2.2 返回的数据 loginnamepasswordTT邮箱必选，使用“接口”2.2 返回的数据 loginname+“univs.user”必选，用户在客户端输入的。返回字段说明：2.1.2 会员登录接口地址：?app=mobile&controller=member&action=login接受参数：返回字段说明：返回数据：se : true,参数useri

5、d名称 用户备注username用户名用户邮箱avatar头像为空，表示没有头像userauth用户 auth用于后续数据提交时验证，在进行本文档 2.2 和 2.3 时使用参数方法名称备注username用户名T必选，“接口”2.3 登录接口返回的 loginName进 行登录。passwordT必选，用户在客户端输入的。参数userid名称用户备注username用户名用户邮箱avatar头像如果为空，表示没有头像userauth用户 auth用于后续数据提交时验证userauth : 6yrhndmkdi8e73jdmr设置意见反馈意见反馈中的上传请使用标准的上传接口处理。接口地址：?a

6、pp=mobile&controller=index&action=feedback接受参数：返回数据：评论评论列表评论列表按发布排序。se : true,message : 提交成功参数方法名称备注userauthT用户 auth必选contentT意见内容必选T邮箱可选，如果已登录，可自动填写用户邮箱app_verT应用版本必选，标识用户使用的应用版本system_ver系统版本必选，标识用户使用机系统和具体的版本号Tdata : userid : 1, username : cmstop, : HYPERLINK mailto:webmastercmstop.dev webmast HY

7、PERLINK mailto:webmastercmstop.dev ercmstop.dev,avatar : ,userauth : 6yrhndmkdi8e73jdmr接口地址：?app=mob接受参数：ment&action=index参数方法名称备注topicidGET评论话题必选pageGET分页页码可选，默认取第一页timeGET更新标识上次获取到的数据更新标识，用于获取更新内容返回字段说明：参数名称备注more是否 用于判断是否显示“”time更新标识数据更新标识，用于下次获取较新数据commentid评论topicid评论followid回复评论如果没有为 0content评

8、论内容createdby评论人会员created评论时间时间戳date评论时间友好的时间格式，如：10 秒前，1 小时前，1 天前使用“接口”2.8.4，传入 username 值获取昵称nickname评论人usernamesus状态1 是待审，2 是通过，注：返回的都是通过审核的supports顶次数数字reports次数数字sensitive是否敏感如果包含为 1，否则为 0istop是否置顶该字段未生效anonymous是否如果是评论，该字段为 1ip评论人 IP 地址location评论人 IP 物理地址中文地址，如：市follow的内容如果 followid 不为 0 时，才会有此

9、字段followdata评论的盖楼信息ipad 版新增,用于生成盖楼返回数据：se : true,more : true,time : 1349863981,data : commentid : 1,topicid : 1,followid : 0,content : 评论内容,createdby : 1,created : 1357612591, / 时间截形式的date : 32 分钟前, / 多少秒前，友好的时间格式nickname : cmstopsus : 2,supports : 0,reports : 0,sensitive : 0, / 是否包含istop : 0,anonym

10、ous : 0,ip : ,location : LAN,followdata: commentid: 3, topicid:1,content : 评论内容,createdby : 1,date : 28 分钟前, / 多少秒前，友好的时间格式nickname : cmstop, commentid: 4, topicid:1,content : 评论内容,createdby : 1,date : 24 分钟前, / 多少秒前，友好的时间格式nickname : cmstop,commentid : 2,topicid : 1,followid : 0,content : 评论内容,crea

11、tedby : 1,created : 1357612591, / 时间截形式的date : 32 分钟前, / 多少秒前，友好的时间格式nickname : cmstopsus : 2,supports : 0,reports : 0,sensitive : 0, / 是否包含istop : 0,anonymous : 0,ip : ,location : LAN, follow : commentid : 1,topicid : 1,followid : 0,content : 评论内容,2.3.2 发布评论接口地址：?app=mob接受参数：ment返回数据：se : true,mess

12、age : 提交成功参数userauth方法名称用户 auth备注必选，用来验证用户信息TtopicidT评论话题必选followidT回复评论可选，对应评论条目的 commentidcontentanonymousT评论内容可选，默认值由服务端设定T是否可选，1 为，0 为真实用户createdby : 1,created : 1357612591, / 时间截形式的date : 32 分钟前, / 多少秒前，友好的时间格式nickname : cmstop sus : 2,supports : 0,reports : 0,sensitive : 0, / 是否包含istop : 0,ano

13、nymous : 0,ip : ,location : LAN2.3.3 顶评论接口地址：?app=mob接受参数：ment&action=support返回数据：返回字段说明：评论2.3.4向服务端想接口地址：?app=mob接受参数：ment&action=report参数方法名称备注userauthT用户 auth必选，用来验证用户信息参数名称备注topicid评论commentid评论supports顶次数se : true,data : topicid : 1,commentid : 1,supports : 1参数userauth方法名称用户 auth备注必选，用来验证用户信息Tc

14、ommentidT评论必选commentidT评论必选返回数据：se : true,data : topicid : 1,commentid : 1,reports : 1返回字段说明：参数名称备注topicid评论commentid评论reports次数尺寸定义3页面位置宽度高度备注幻灯片640314固定尺寸栏目ICO4848固定尺寸列表配图160120固定尺寸内容中小图小图只要排好版最大尺寸中大图不大于 320不大于 480最大尺寸组图挂件，缩略图不大于 320不大于 480挂件，缩略图不大于 320不大于 480列表瀑布流宽度300不限制高不限制内容中原图原图最大尺寸列表配图160120固定尺寸内容中缩略图580420最大尺寸4服务端配置注：尺寸，也属于服务端配置。模块配置值备注评论评论0/10 允许评论，1 登陆后才能评论评论是否审核0端不需要审核评论评论每页条数10服务端固定报料报料0/10 允许报料，1 登陆后才能报料报料数量10 张报料大小2MM报料大小200MM意见反馈数量暂时不上传天气默认城市weatherid每页条