周蓉君 / API-Interfaces · Commits

Go to a project

Authored by liqingzhong
Commit 1c4b2f4401e7eb7b6b7493b585c9f8ce7ca678f5 2 parents d0f7f519 3e0e96ed

Merge branch 'master' of http://git.dev.yoho.cn/yoho-documents/api-interfaces

Inline Side-by-side
Showing 2 changed files with 435 additions and 0 deletions
## 1、为你优选接口##
（method=app.home.newPreference）
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|yh_channel|String|否|1|null|性别|
|uid|String|是|10961107|null|用户ID|
|udid|String|否|7ce5433b0eb9b527599fd5ef319773bc2f5d94d8|null|设备号|
注意，通用的头部没有列出。
请求示例
http://devapi.yoho.cn:58078/?debug=XYZ&app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=app.home.newPreference&yh_channel=1&udid=7ce5433b0eb9b527599fd5ef319773bc2f5d94d8&uid=10961107
### 响应
code为200即为成功，否则是失败。
响应JSON格式如下所示:
```json
{
"alg": "SALT_MD5",
"code": 200,
"data": {
"product_list": [
{
"brand_domain": "5cm",
"brand_id": 4,
"brand_name": "5CM",
"cn_alphabet": "5CMPeiShi5CXTIT0600S66",
"default_images": "http://img13.static.yhbimg.com/goodsimg/2016/02/21/07/026d569b2db7d9ce9339a79bcb3fe420f8.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"edit_time": 1456119592,
"gender": "1",
"goods_list": [
{
"color_code": "333333",
"color_id": "2",
"color_name": "黑色",
"color_value": "",
"cover_1": "",
"cover_2": "",
"goods_id": "476147",
"images_url": "http://img13.static.yhbimg.com/goodsimg/2016/02/21/07/026d569b2db7d9ce9339a79bcb3fe420f8.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"is_default": "N",
"product_skc": "346699",
"status": "1"
}
],
"is_advance": "N",
"is_discount": "N",
"is_limited": "N",
"is_new": "Y",
"is_outlets": 2,
"is_promotion": 104,
"is_soon_sold_out": "N",
"is_special": "N",
"market_price": 359,
"max_sort_id": 8,
"middle_sort_id": 66,
"product_id": 373507,
"product_name": "5CM 字母印花领带",
"product_skn": 51206745,
"sales_num": 0,
"sales_phrase": "春潮新势力",
"sales_price": 359,
"shelve_time": 1457140500,
"small_sort_id": 77,
"status": 1,
"stock_number": 25,
"storage_num": 25,
"tags": [
"is_new"
],
"vip1_price": 341.05,
"vip2_price": 323.1,
"vip3_price": 315.92,
"vip_discount_type": 1,
"vip_price": 0
},
{
"brand_domain": "5cm",
"brand_id": 4,
"brand_name": "5CM",
"cn_alphabet": "5CMPeiShi5CXTIT0603S66",
"default_images": "http://img12.static.yhbimg.com/goodsimg/2016/02/21/07/02d463c9f8945ad14f824e8ba35efb9555.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"edit_time": 1456119581,
"gender": "1",
"goods_list": [
{
"color_code": "333333",
"color_id": "2",
"color_name": "黑色",
"color_value": "",
"cover_1": "",
"cover_2": "",
"goods_id": "476153",
"images_url": "http://img12.static.yhbimg.com/goodsimg/2016/02/21/07/02d463c9f8945ad14f824e8ba35efb9555.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"is_default": "N",
"product_skc": "346702",
"status": "1"
}
],
"is_advance": "N",
"is_discount": "N",
"is_limited": "N",
"is_new": "Y",
"is_outlets": 2,
"is_promotion": 104,
"is_soon_sold_out": "N",
"is_special": "N",
"market_price": 359,
"max_sort_id": 8,
"middle_sort_id": 66,
"product_id": 373513,
"product_name": "5CM 字母印花领结",
"product_skn": 51206748,
"sales_num": 0,
"sales_phrase": "春潮新势力",
"sales_price": 359,
"shelve_time": 1457140500,
"small_sort_id": 77,
"status": 1,
"stock_number": 19,
"storage_num": 19,
"tags": [
"is_new"
],
"vip1_price": 341.05,
"vip2_price": 323.1,
"vip3_price": 315.92,
"vip_discount_type": 1,
"vip_price": 0
}
],
"rec_id": "00f185af-936a-4053-97f8-1c802cb91e8b"
},
"md5": "ace93d0f598db0bebec30234381c0cbf",
"message": "Product List."
}
```
## 2、猜你喜欢接口##
（method=app.search.newLast7day）
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|yh_channel|String|是|1|null|性别|
|limit|int|是|2|20|每页显示条数|
|page|int|是|1|1|第几页|
|gender|String|是|2|null|性别|
|content_code|String|是|123abc|null|内容码|
|uid|String|是|10961107|null|用户ID|
|udid|String|是|7ce5433b0eb9b527599fd5ef319773bc2f5d94d8|null|设备号|
注意，通用的头部没有列出。
请求示例
http://devapi.yoho.cn:58078/?debug=XYZ&app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=app.search.newLast7day&yh_channel=3&udid=7ce5433b0eb9b527599fd5ef319773bc2f5d94d8&uid=10961107&limit=2
### 响应
code为200即为成功，否则是失败。
响应JSON格式如下所示:
```json
{
"alg": "SALT_MD5",
"code": 200,
"data": {
"page": 1,
"page_total": 1,
"product_list": [
{
"brand_domain": "lal",
"brand_id": 208,
"brand_name": "Life·After Life",
"cn_alphabet": "LIFEAFTERLIFEXiuXianJiuFenKuLALA6019P82",
"default_images": "http://img11.static.yhbimg.com/goodsimg/2016/01/18/05/014ad6e86ae379f532b4099ff3f815cd76.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"edit_time": 1457317305,
"gender": "1",
"goods_list": [
{
"color_code": "47ba17",
"color_id": "6",
"color_name": "绿色",
"color_value": "",
"cover_1": "http://img10.static.yhbimg.com/goodsimg/2016/01/18/05/01da8b818522c050c240550cc4761bdc7e.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"cover_2": "",
"goods_id": "402517",
"images_url": "http://img12.static.yhbimg.com/goodsimg/2016/01/06/12/0294c7537aa16803067d59d080d77d026a.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"is_default": "N",
"product_skc": "305513",
"status": "1"
},
{
"color_code": "333333",
"color_id": "2",
"color_name": "黑色",
"color_value": "",
"cover_1": "http://img11.static.yhbimg.com/goodsimg/2016/01/18/05/014ad6e86ae379f532b4099ff3f815cd76.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"cover_2": "",
"goods_id": "402519",
"images_url": "http://img11.static.yhbimg.com/goodsimg/2016/01/06/12/01b2aebd8666a078319943dc67af25643f.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"is_default": "Y",
"product_skc": "305514",
"status": "1"
},
{
"color_code": "0000fe",
"color_id": "7",
"color_name": "蓝色",
"color_value": "",
"cover_1": "",
"cover_2": "",
"goods_id": "402521",
"images_url": "http://img13.static.yhbimg.com/goodsimg/2016/01/06/12/021a3546c399ca5e191338dea14ed9111d.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"is_default": "N",
"product_skc": "305515",
"status": "1"
},
{
"color_code": "8b5402",
"color_id": "4",
"color_name": "棕色",
"color_value": "",
"cover_1": "",
"cover_2": "",
"goods_id": "402523",
"images_url": "http://img13.static.yhbimg.com/goodsimg/2016/01/06/12/022ad04aaae79cf551d6357b7756b24564.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"is_default": "N",
"product_skc": "305516",
"status": "1"
}
],
"is_advance": "N",
"is_discount": "Y",
"is_limited": "N",
"is_new": "Y",
"is_outlets": 2,
"is_promotion": 103,
"is_soon_sold_out": "N",
"is_special": "N",
"market_price": 299,
"max_sort_id": 3,
"middle_sort_id": 26,
"product_id": 312769,
"product_name": "Life·After Life 侧拉链撞色绣标休闲九分裤",
"product_skn": 51173990,
"sales_num": 0,
"sales_phrase": "",
"sales_price": 239,
"shelve_time": 1457317305,
"small_sort_id": 129,
"status": 1,
"stock_number": 794,
"storage_num": 794,
"tags": [
"is_new"
],
"vip1_price": 227.04999999999998,
"vip2_price": 215.1,
"vip3_price": 210.32,
"vip_discount_type": 4,
"vip_price": 191
},
{
"brand_domain": "lal",
"brand_id": 208,
"brand_name": "Life·After Life",
"cn_alphabet": "LIFEAFTERLIFEKaiShanWeiYiLALA601HA43",
"default_images": "http://img12.static.yhbimg.com/goodsimg/2016/01/11/04/023c8a7f7cca543bb06eeb1c491e8133dc.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"edit_time": 1456897775,
"gender": "1",
"goods_list": [
{
"color_code": "333333",
"color_id": "2",
"color_name": "黑色",
"color_value": "",
"cover_1": "http://img12.static.yhbimg.com/goodsimg/2016/01/11/04/023c8a7f7cca543bb06eeb1c491e8133dc.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"cover_2": "",
"goods_id": "402593",
"images_url": "http://img11.static.yhbimg.com/goodsimg/2016/01/11/04/01481682960df4ca7eef351e879efff375.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"is_default": "N",
"product_skc": "305551",
"status": "1"
},
{
"color_code": "0000fe",
"color_id": "7",
"color_name": "蓝色",
"color_value": "",
"cover_1": "http://img13.static.yhbimg.com/goodsimg/2016/01/11/04/02ddbd05ad24fa7805705e310f38d9d498.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"cover_2": "",
"goods_id": "402595",
"images_url": "http://img11.static.yhbimg.com/goodsimg/2016/01/11/04/0144ce271da759c861c49fba3c59c542ed.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"is_default": "N",
"product_skc": "305552",
"status": "1"
},
{
"color_code": "b9b7af",
"color_id": "3",
"color_name": "灰色",
"color_value": "",
"cover_1": "",
"cover_2": "",
"goods_id": "402597",
"images_url": "http://img13.static.yhbimg.com/goodsimg/2016/01/05/10/02877fc6b8d591343daded50497aaa5b42.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"is_default": "N",
"product_skc": "305553",
"status": "1"
},
{
"color_code": "47ba17",
"color_id": "6",
"color_name": "绿色",
"color_value": "",
"cover_1": "",
"cover_2": "",
"goods_id": "402599",
"images_url": "http://img13.static.yhbimg.com/goodsimg/2016/01/07/12/02f4b6ed457548a251fec23b67bd45d91a.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"is_default": "N",
"product_skc": "305554",
"status": "1"
},
{
"color_code": "FFFFFF",
"color_id": "1",
"color_name": "白色",
"color_value": "",
"cover_1": "http://img11.static.yhbimg.com/goodsimg/2016/01/11/05/0132a3a5039523d8b128a7e9fae579e87a.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"cover_2": "",
"goods_id": "402601",
"images_url": "http://img10.static.yhbimg.com/goodsimg/2016/01/11/04/01be579fbec81ad948397e69323fd0b8db.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"is_default": "N",
"product_skc": "305555",
"status": "1"
}
],
"is_advance": "N",
"is_discount": "Y",
"is_limited": "N",
"is_new": "N",
"is_outlets": 2,
"is_promotion": 102,
"is_soon_sold_out": "N",
"is_special": "N",
"market_price": 239,
"max_sort_id": 1,
"middle_sort_id": 16,
"product_id": 312795,
"product_name": "Life·After Life 无拉链前襟开叉开衫卫衣",
"product_skn": 51174003,
"sales_num": 0,
"sales_phrase": "",
"sales_price": 189,
"shelve_time": 1456897775,
"small_sort_id": 119,
"status": 1,
"stock_number": 731,
"storage_num": 731,
"tags": [],
"vip1_price": 179.54999999999998,
"vip2_price": 170.1,
"vip3_price": 166.32,
"vip_discount_type": 3,
"vip_price": 0
}
],
"rec_id": "81018161-8459-4131-ac05-40f327b5e318",
"total": 2
},
"md5": "aefa8f6557793d3b115d03d221a24529",
"message": "Last Search List."
}
```
\ No newline at end of file
... ...
## 1、获取用户可用的优惠券张数 ##
#### 说明
获取用户可用的优惠券张数（app.Shopping.countUsableCoupon）
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|uid|int|否|3236556|0|用户id|
### 响应
code为200即为成功，否则是失败。
响应JSON格式如下所示:
```json
{
"alg":"SALT_MD5",
"code":200,
"data":{"count":5},
"md5":"c1d725306fb09dcbf504776d276521cb",
"message":"ok"
}
```
## 2、获取用户可用和不可用优惠券列表 ##
#### 说明
获取用户优惠券列表，可用和不可用（app.Shopping.listCoupon）
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|uid|int|否|3236556|0|用户id|
### 响应
code为200即为成功，否则是失败。
响应JSON格式如下所示:
```json
{
"alg": "SALT_MD5",
"code": 200,
"data": {
"usable_coupons":[
{
"coupon_code": "amccccc",
"coupon_name": "生日券",
"coupon_type": "3",
"coupon_validity": "2013.11.01-2017.01.31",
"coupon_value": "55"
}
],
"unusable_coupons": [
{
"coupon_code": "ambb2345",
"coupon_name": "生日券",
"coupon_type": "3",
"coupon_validity": "2013.11.01-2017.01.31",
"coupon_value": "55"
}
]
},
"md5": "c1d725306fb09dcbf504776d276521cb",
"message": "ok"
}
```
\ No newline at end of file
... ...