周蓉君 / API-Interfaces · Commits

Go to a project

Authored by LUOXC
Commit 6a3ca4e60b8ed20b952f4f3f3ca7109bf5324fa5 2 parents f94eacb6 f9eaf378

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

# Conflicts:
#	订单/保存预支付信息接口.md
Inline Side-by-side
Showing 4 changed files with 190 additions and 18 deletions
... ... @@ -211,11 +211,11 @@ code为200即为成功，否则是失败。
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|shop|string|是|649|null|店铺id|
|shop_id|string|是|649|null|店铺id|
注意，通用的头部没有列出，其他条件同原来保持一致。
请求示例
http://devapi.yoho.cn:58078/gateway/?limit=20&method=app.search.li&order=s_n_desc&page=1&productSize=240x319&shop=649&v=7&yh_channel=&query=MACROPUS&debug=XYZ
http://devapi.yoho.cn:58078/gateway/?limit=20&method=app.search.li&order=s_n_desc&page=1&productSize=240x319&shop_id=649&v=7&yh_channel=&query=MACROPUS&debug=XYZ
### 响应
code为200即为成功，否则是失败。
响应JSON格式如下所示:
... ... @@ -598,7 +598,7 @@ code为200即为成功，否则是失败。
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|shops_id|int|否|356|无|店铺id|
|shop_id|int|否|356|无|店铺id|
|yh_channel|string|是|1|无|频道|
|gender|string|是|1|无|性别|
... ... @@ -761,11 +761,11 @@ code为200即为成功，否则是失败。
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|shop|string|是|649|null|店铺id|
|shop_id|string|是|649|null|店铺id|
注意，通用的头部没有列出，其他条件同原来保持一致。
请求示例
http://devapi.yoho.cn:58078/gateway/?limit=20&method=app.search.li&order=s_n_desc&page=1&productSize=240x319&shop=649&v=7&yh_channel=&query=MACROPUS&debug=XYZ
http://devapi.yoho.cn:58078/gateway/?limit=20&method=app.search.li&order=s_n_desc&page=1&productSize=240x319&shop_id=649&v=7&yh_channel=&query=MACROPUS&debug=XYZ
### 响应
code为200即为成功，否则是失败。
响应JSON格式如下所示:
... ... @@ -1150,7 +1150,7 @@ code为200即为成功，否则是失败。
|:-------| -----:|-----:|-----:|-----:|----:|
|yh_channel|string|是|1|null|频道id|
|brand|string|是|649|null|品牌id|
|shop|string|是|649|null|店铺id|
|shop_id|string|是|649|null|店铺id|
|order|string|是|s_n_desc|null|排序规则|
|limit|int|是|20|20|每页数据大小|
|page|int|是|1|1|当前页|
... ... @@ -1695,7 +1695,7 @@ code为200即为成功，否则是失败。
|categoryId|string|否|5|无|二级分类id|
|subCategoryId|string|是|45|无|三级分类id|
|sort|string|否|114,293|无|三级子分类id|
|shop|string|否|635|无|店铺id|
|shop_id|string|否|635|无|店铺id|
注意，通用的头部没有列出，同原来分类商品列表接口。
请求示例
... ... @@ -2610,4 +2610,147 @@ code为200即为成功，否则是失败。
"md5": "3294e4beb6a3c83349a3879e81d3c2ac",
"message": "Category Product List."
}
```
## 14、yoho所有品牌列表接口##
（method=app.brand.brandlist）
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|yh_channel|string|是|1|无|频道id|
品牌店铺需求，需要在品牌列表的每个品牌上增加用于跳转的枚举值type：
无店铺：0--->品牌页
无单品店有多品店：1--->搜索页
有单品店：2--->店铺页面
请求示例
http://127.0.0.1:8080/gateway/?method=app.brand.brandlist&v=7&yh_channel=1&debug=XYZ
### 响应
code为200即为成功，否则是失败。
响应JSON格式如下所示:
```json
{
"alg": "SALT_MD5",
"code": 200,
"data": {
"brands": {
"": [
{
"brand_alif": "",
"brand_domain": "dirtlun",
"brand_ico": "http://img13.static.yhbimg.com/brandLogo/2016/03/23/13/02bcd71ac660607888bd58af8d21b8a0c1.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"brand_keyword": "",
"brand_name": "第二轮",
"brand_name_cn": "",
"brand_name_en": "第二轮",
"hot_keyword": "",
"id": "1559",
"is_hot": "2",
"is_show_new": "N",
"shop_id": 647,
"type": "2"
},
{
"brand_alif": "",
"brand_domain": "rtytry",
"brand_ico": "http://img10.static.yhbimg.com/brandLogo/2016/03/18/14/010e6e67e28597232f89fb4ddb34babf28.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"brand_keyword": "",
"brand_name": "请不要用我的品牌，谢谢",
"brand_name_cn": "",
"brand_name_en": "ytiuyi",
"hot_keyword": "",
"id": 1555,
"is_hot": "N",
"is_show_new": "N",
"type": "1"
}
],
"0~9": [
{
"brand_alif": "5",
"brand_domain": "5preview",
"brand_ico": "http://img13.static.yhbimg.com/brandLogo/2015/11/17/16/02202c3d541b9b0b67aaf32068b32f4884.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"brand_keyword": "趣味,休闲",
"brand_name": "5 PREVIEW",
"brand_name_cn": "",
"brand_name_en": "5 PREVIEW",
"hot_keyword": "",
"id": 526,
"is_hot": "N",
"is_show_new": "N",
"type": "0"
}
]
}
},
"message": "success"
}
```
## 15、根据品牌id查询店铺列表接口##
（method=app.shop.queryShopsByBrandId）
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|brand_id|int|否|526|无|品牌id|
http://127.0.0.1:8080/gateway/?method=app.shop.queryShopsByBrandId&v=7&brand_id=526&debug=XYZ
### 响应
code为200即为成功，否则是失败。
响应JSON格式如下所示:
```json
{
"alg": "SALT_MD5",
"code": 200,
"data": [
{
"brand_domain": "http://img13.static.yhbimg.com/brandLogo/2015/11/17/16/02202c3d541b9b0b67aaf32068b32f4884.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
"brand_id": 526,
"brand_name": "5 PREVIEW"
}
],
"md5": "a69d83093e3d3ebc864a06e6da2ee17f",
"message": "product brandshop Intro"
}
{
"alg": "SALT_MD5",
"code": 200,
"data": [
{
"brand_domain": "",
"brand_id": 1559,
"brand_name": "新增店铺1222",
"shop_id": 636
},
{
"brand_domain": "/2016/03/29/20/0160698e7d0b06a2ed21cfbae3c50a32eb.jpg",
"brand_id": 1559,
"brand_name": "33333",
"shop_id": 641
},
{
"brand_domain": "",
"brand_id": 1559,
"brand_name": "了极乐空间立刻见拉开距离靠捡垃圾立刻见拉开距离靠捡垃圾立刻见李经理李经理建立建立极乐空间看见了据了解立刻见",
"shop_id": 647
},
{
"brand_domain": "/2016/04/08/16/0130ff219200cb6dcfc25b9a2c572133c3.jpg",
"brand_id": 1559,
"brand_name": "拉通测试店铺A勿动，谢谢！",
"shop_id": 670
},
{
"brand_domain": "/2016/04/09/14/013d7e1b2519d3f8c1ecbdd4e929fbf456.jpg",
"brand_id": 1559,
"brand_name": "周六加班测店铺",
"shop_id": 672
}
],
"md5": "d4fb7018f27973c1f00ebaae579c02c7",
"message": "product brandshop Intro"
}
```
\ No newline at end of file
... ...
... ... @@ -4,17 +4,16 @@
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|uid|int|否|205455||用户id|
|product_skn|String|否|12556||skn|
|product_sku|String|否|25665||sku|
|product_skc|String|否|15566||skc|
|color_name|String|否|蓝色||颜色|
|uid|String|否|3566164||用户id|
|product_skn|String|否|50001796||skn|
|product_sku|String|否|102034||sku|
|product_skc|String|否|14||skc|
|color_name|String|否|黑||颜色|
|size_name|String|否|L||尺码|
注意，通用的头部没有列出。
请求示例
http://192.168.102.205:8080/gateway?method=app.limitProduct.userChoiceSku&uid=12342&productSkn=56665&productSku=222&colorName=蓝色&sizeName=L&productSkc=15556
http://192.168.102.205:8080/gateway?method=app.limitProduct.userChoiceSku&uid=3566164&product_skn=50001796&product_sku=102034&product_skc=14&size_name=L&color_name=黑
### 响应
code为200即为成功，否则是失败。
响应参数，data部分
... ... @@ -44,11 +43,11 @@ code为200即为成功，否则是失败。
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|skn|String|否|205455||用户id|
|product_skn|String|否|50001796||用户id|
注意，通用的头部没有列出。
请求示例
http://192.168.102.205:8080/activity?method=app.limitProduct.getGoodListBySkus&skn=12342
http://192.168.102.205:8080/gateway?method=app.limitProduct.getLimitProductDataBySkn&debug=XYZ&product_skn=50001796
### 响应
code为200即为成功，否则是失败。
... ... @@ -176,7 +175,7 @@ code为200即为成功，否则是失败。
|limit|Integer|1-3|是|||分页大小|
注意，通用的头部没有列出。
请求示例http://127.0.0.1:8090/activity/?method=app.drawline.addQueue&limitProductCode=3&app_version=4.0.1&uid=109&activityId=11
请求示例http://127.0.0.1:8090/activity/?method=app.drawline.addQueue&app_version=4.0.1&uid=109&activityId=11
### 响应
code为200即为成功，否则是失败。
... ...
# 购物车服务接口
### 购物车查询
### 接口说明
| 接口说明 | 接口说明 |
| :-- | -----: |
| 接口名 | app.Shopping.cart |
| 接口说明 | 查询购物车 |
| http请求方式 | GET/POST |
### 请求参数
| 名称 | 类型 | 是否必须 | 示例值 | 默认值 | 描述 |
| :-- | :-- | :-- | :-- | :-- | :-- |
| method | string | 是 | app.Shopping.cart | | |
| uid | int | 否 | 5772257 | | |
| shopping_key | string | 否 | c36408a268e9b9418189d9a71967379e | | |
| sale_channel | string | 否 | 1 | 1 | |
### 正常返回结果
```json
{
}
```
\ No newline at end of file
... ...
... ... @@ -46,9 +46,12 @@
| 25 | 银联在线支付 |
| 26 | QQ钱包手机支付 |
| 40 | QQ支付 |
> 备注：app 支付宝支付 发送15 （包括支付宝手机和支付宝wap）
### 请求示例
http://192.168.102.205:8080/gateway?method=app.order.savePrePayInfo&uid=8041834&orderCode=111111111&payment=1&debug=XYZ
### 正常返回结果
#### 正常返回结果
```json
{
"alg": "SALT_MD5",
... ...