android商场系统

二、通信接口

2.1 公共数据部分

采用短链接的 http 协议进行通讯,提交方式为 post 和 get 两种方式，返回的数据

类型为 JSON

2.1.1 公共头部

所有接口请求均包含以下头信息(Http Request Header)

参数名称 类型 是否必须 参数值示例 说明

appkey String Y 123456 软件身份 key

userid String N 12345 用户 ID

usersession String N Cbaq4fxvb 登陆后得到的用户唯一性标识

unique String N xvbvsfsgdsg 激活后得到的设备唯一性标识

所有通信均无加解密信息，参数解释：

appkey 身份标识，服务器端进行识别

udid 客户端硬件标识

os ios& android& WM7

osversion 5.0

appversion app 发布版本

sourceid

{

"response": "error",

"error": {

"text": "用户名不存在"

}

}

b type 类型：

type description

1

限时抢购

5

推荐品牌

c 排序

sale_down(销量降序)，price_up(价格升序)，price_down(价格降序)，comment_down(评价降

序)，shelves_down(上架降序)。目前只有价格有双向排序，其他都只有降序，其中默认为

sale_down

d 商品列表

有很多种商品列表页，逻辑大同小异，但为了定位和区分统计，采用不同 URL 请求

e 请求类型：

一般情况下

GET /home

参数名称 描述 样例

无

服 务 器 返

回数据

描述 样例

模块

home_banner 轮转大

图，点击进入专题商

品列表页

home_classlist 多 功 能

"home_banner": //轮转大图 320*125

"pic": "http://localhost/1.png" //专题图片 URL

},

{

"id": 124,

"title": "活动 2",

"pic": "http://localhost/1.png"

}

],

"home_classlist": [

{

"type": 2, //2 为促销快报

"title": "促销快报",

"pic": "http://localhost/2.png", //icon 图片 URL，点击进入/topic

},

{

"type": 3, //3 为新品上架

"title": "新品上架",

"pic": "http://localhost/3.png", //icon 图片 URL，点击进入/newproduct

},

{

"title": "推荐品牌",

"pic": "http://localhost/5.png", //icon 图片 URL，点击进入/brand

}

],

}

2.3 搜索

2.3.1 搜索推荐

发送方式 发送 URL 备注

GET /search/recommend

参数名称 描述 样例

2.3.2 搜索商品列表

发送方式 发送 URL 备注

orderby

回数据

"response": "search",

"productlist": //搜索商品列表

[