您好,欢迎访问三七文档
当前位置:首页 > 商业/管理/HR > 信息化管理 > 红孩子客户端手机接口
二、通信接口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:homehome_banner://轮转大图320*125[{id:123,//专题idtitle:活动1,//专题标题pic:专题图片URL},{id:124,title:活动2,pic:}],home_classlist:[{type:1,//1为限时抢购id:123,//限时抢购IDtitle:限时抢购,//descriptionpic:图片URL,点击进入/limitbuy},{type:2,//2为促销快报title:促销快报,pic:图片URL,点击进入/topic},{type:3,//3为新品上架title:新品上架,pic:图片URL,点击进入/newproduct},{type:4,//4为热门单品title:热门单品,pic:图片URL,点击进入/hotproduct},{type:5,//5为新品上架title:推荐品牌,pic:图片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(价格降序),comment_down(评价降序),shelves_down(上架降序)。目前只有价格有双向排序,其他都只有降序,其中默认为sale_down服务器返回数据描述样例搜索商品列表页{response:search,productlist://搜索商品列表[{id:1102539,//商品IDname:雅培金装,//商品名称pic:,//商品图片URLmarketprice:79,//市场价price:78,//会员价},{id:1102539,//商品IDname:雅培金装,//商品名称pic:,//商品图片URLmarketprice:79,//市场价price:78,//会员价}],list_count:1500//商品总数}2.4专题及品牌2.4.1促销快报发送方式发送URL备注GET/topic参数名称描述样例page第几页1pageNum每页多少个8服务器返回数据描述样例{response:topic,topic:[{id:专题活动ID,name:专题活动名称,pic:图片URL},{id:专题活动ID,name:专题活动名称,pic:图片URL}]}2.4.2推荐品牌发送方式发送URL备注GET/brand参数名称描述样例无服务器返回数据描述样例CMS定制的推荐品牌{response:brand,brand:[{key:孕妈专区,//分区名称value:[{id:1201//品牌编号name:ain,//品牌名称pic://品牌图片URL},{id:1201//品牌编号name:ain,//品牌名称pic://品牌图片URL}]},{key:营养食品,value:[{id:1201//品牌编号name:ain,//品牌名称pic://品牌图片URL},{id:1201//品牌编号name:ain,//品牌名称pic://品牌图片URL}]}]}2.4.3限时抢购发送方式发送URL备注GET/limitbuy参数名称描述样例page第几页pageNum每页个数orderby排序sale_down(销量降序),price_up(价格升序),price_down(价格降序),comment_down(评价降序),shelves_down(上架降序)。目前只有价格有双向排序,其他都只有降序,其中默认为sale_down服务器返回数据描述样例{response:limitbuy,productlist:[{id:1102539,//商品IDname:雅培金装,//商品名称pic:,//商品图片URLprice:79,//会员价limitprice:78,//限时特价lefttime:3600//剩余时间,单位为秒},{id:1102539,//商品IDname:雅培金装,//商品名称pic:,//商品图片URLprice:79,//会员价limitprice:78,//限时特价lefttime:3600//剩余时间,单位为秒}],list_count:1500//商品总数}2.4.4新品上架发送方式发送URL备注GET/newproduct参数名称描述样例page第几页pageNum每页个数orderby排序sale_down(销量降序),price_up(价格升序),price_down(价格降序),comment_down(评价降序),shelves_down(上架降序)。目前只有价格有双向排序,其他都只有降序,其中默认为sale_down服务器返回数据描述样例{response:newproduct,productlist:[{id:1102539,//商品IDname:雅培金装,//商品名称pic:,//商品图片URLmarketprice:79,//市场价price:78,//会员价},{id:1102539,//商品IDname:雅培金装,//商品名称pic:,1//商品图片URLmarketprice:79,//市场价price:78,//会员价}],list_count:1500//商品总数}2.4.5热门单品发送方式发送URL备注GET/hotproduct参数名称描述样例page第几页pageNum每页个数orderby排序sale_down(销量降序),price_up(价格升序),price_down(价格降序),comment_down(评价降序),shelves_down(上架降序)。目前只有价格有双向排序,其他都只有降序,其中默认为sale_down服务器返回数据描述样例{response:hotproduct,productlist:[{id:1102539,//商品IDname:雅培金装,//商品名称pic:,//商品图片URLmarketprice:79,//市场价price:78,//会员价},{id:1102539,//商品IDname:雅培金装,//商品名称pic:,//商品图片URLmarketprice:79,//市场价price:78,//会员价}],list_count:1500//商品总数}2.4.6专题商品列表发送方式发送URL备注GET/topic/plist参数名称描述样例page第几页1pageNum每页个数10id专题ID1234orderby排序sale_down(销量降序),price_up(价格升序),price_down(价格降序),comment_down(评价降序),shelves_down(上架降序)。目前只有价格有双向排序,其他都只有降序,其中默认为sale_down服务器返回数据描述样例{response:topic_productlist,productlist:[{id:1102539,//商品IDname:雅培金装,//商品名称pic:,//商品图片URLmarketprice:79,//市场价price:78,//会员价},{id:1102539,//商品IDname:雅培金装,//商品名称pic:,//商品图片URLmarketprice:79,//市场价price:78,//会员价}],list_count:1500//商品总数}2.4.7品牌商品列表发送方式发送URL备注GET/brand/plist参数名称描述样例page第几页1pageNum每页个数10id品牌ID1234orderby排序sale_down(销量降序),price_up(价格升序),price_down(价格降序),comment_down(评价降序),shelves_down(上架降序)。目前只有价格有双向排序,其他都只有降序,其中默认为sale_down服务器返回数据描述样例{response:brand_productlist,productlist:[{id:1102539,//商品IDname:雅培金装,//商品名称pic:,//商品图片URLmarketprice:79,//市场价price:78,//会员价},{id:1102539,//商品IDname:雅培金装,//商品名称pic:,//商品图片URLmarketprice:79,//市场价price:78,//会员价}],list_count:1500//商品总数}2.5分类及详情2.5.1分类请求发送方式发送URL备注GET/category参数名称描述样例version版本号1.0服务器返回数据描述样例一次性返回所有分类信息,服务器端根
本文标题:红孩子客户端手机接口
链接地址:https://www.777doc.com/doc-1535688 .html