关于万年历补丁接口参数和返回结果字段的说明

概述：

  1. 统一数据结构（返回和提交）；
  2. 数据返回时，字段命名统一以小写开头；
  3. 日期格式统一以字符串形式传输（返回和提交）；

公共参数（提交时） 每次提交接口时，都请提交这些参数；业务参数请务必不要与这些参数重名；

参数名(QueryString中) 全名 取值范例 说明
cid ClientId Youloft_Android
av AppVersion 4.2.6
mac MAC地址 00:11:22:33:44:55
idfa IDFA iOS下所取得的唯一物理地址标识
did DeviceId b622c089e7e14d2c2fa8c9129dafbb51
chn ChannelId wnl_anzhi
cc country CN
lang language zh
bd Bundle com.youloft.calendar

所以，每一次请求都应该形如：

    
                http://localhost:3279/api/GetTopContent?cid=Youloft_Android&av=4.2.6&mac=00:11:22:33:44:55&did=b622c089e7e14d2c2fa8c9129dafbb51&chn=wnl_anzhi&cc=CN&lang=zh&bd=com.youloft.calendar&t=1430366273

公共结构 数据返回采用Json格式；

参数名 类型 取值范围 说明
status int 见以下说明 请求处理的状态
msg String 针对Status属性的说明信息，如果Status = 200， 则此字段为空
t long 记录的返回时间的时间戳
dateTime DateTime 记录的返回时间
server String 服务器实例
Data 不固定，随实际业务而定 返回的业务字段，这个才是业务开发人员关心的部分
sign String 签名 - 用于缓存

Status

数字 对应类别
200 成功
201 失败
202 异常
203 未授权
204 非法路径
304 未修改
9999 Unknown