红孩子客户端手机接口.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，点击进入/newproduct},{"type":4,//4为热门单品"title":"热门单品","pic":"http://localhost/4.png",//icon图片URL，点击进入/hotproduct},{"type":5,//5为新品上架"title":"推荐品牌","pic":"http://localhost/5.png",//icon图片URL，点击进入/brand}],}2.3搜索2.3.1搜索推荐发送方式发送URL备注GET/search/recommend参数名称描述样例无服务器返回数据描述样例搜索页面调用获取推荐搜索词搜索历史为本地的缓存{"response":"searchrecommend","search_keywords":[//CMS定义推荐关键词，如无为空"adidas","361","nike"]}2.3.2搜索商品列表发送方式发送URL备注GET/search参数名称描述样例keyword搜索关键字keyword=奶粉page第几页1pageNum每页多少个10orderby排序sale_down(销量降序)，price_up(价格升序)，price_down(