红孩子客户端手机接口.doc

二、通信接口2.1公共数据部分采用短链接的http协议进行通讯,提交方式为post和get两种方式，返回的数据类型为JSON2.1.1公共头部所有接口请求均包含以下头信息(HttpRequestHeader)参数名称类型是否必须参数值示例说明appkeyStringY123456软件身份keyudidStringYudidorimei手机客户端的唯一标识osStringYIphoneos操作系统名称osversionStringY5.0操作系统版本appversionStringY1.0.0APP版本sourceidStringYYek_test推广IDverStringY0.9通讯协议版本useridStringN12345用户IDusersessionStringNCbaq4fxvb登陆后得到的用户唯一性标识uniqueStringNxvbvsfsgdsg激活后得到的设备唯一性标识所有通信均无加解密信息，参数解释：appkey身份标识，服务器端进行识别udid客户端硬件标识osios&android&WM7osversion5.0appversionapp发布版本sourceidveruserid登录完之后传客户端usersession登录标识uniqueapp自动激活后服务器返回标识2.2.2一些规范a错误码返回格式：{"response":"error","error":{"text":"用户名不存在"}}btype类型：typedescription1限时抢购2促销快报3新品上架4热门单品5推荐品牌c排序sale_down(销量降序)，price_up(价格升序)，price_down(价格降序)，comment_down(评价降序)，shelves_down(上架降序)。目前只有价格有双向排序，其他都只有降序，其中默认为sale_downd商品列表有很多种商品列表页，逻辑大同小异，但为了定位和区分统计，采用不同URL请求e请求类型：一般情况下抓取数据的请求，皆为GET和服务器有交互的请求，皆为POST2.2.3请求host初定请求host为mobile.binggo.com2.2首页发送方式发送URL备注GET/home参数名称描述样例无服务器返回数据描述样例模块home_banner轮转大图，点击进入专题商品列表页home_classlist多功能列表，按顺序限时{"response":"home""home_banner"://轮转大图320*125[{"id":123,//专题id"title":"活动1",//专题标题"pic":"http://localhost/1.png"//专题图片URL},{"id":124,"title":"活动2","pic":"http://localhost/1.png"}],"home_classlist":[{"type":1,//1为限时抢购"id":123,//限时抢购ID"title":"限时抢购",//description"pic":"http://localhost/1.png"//icon图片URL，点击进入/limitbuy},{"type":2,//2为促销快报"title":"促销快报","pic":"http://localhost/2.png",//icon图片URL，点击进入/topic},{"type":3,//3为新品上架"title":"新品上架","pic":"http://localhost/3.png",//icon图片URL，点击进