ttj1314 / API-Interfaces · Commits

Go to a project

Authored by ping
Commit 9bd2417b3edb1a4e733b65bcc80a42878c37d6e5 1 parent 63614f1c

邀请好友赢福利

Inline Side-by-side
Showing 1 changed file with 400 additions and 0 deletions
  1 +## 1、用户选择/修改活动商品的sku信息 ##
  2 +
  3 +用户选择/修改活动商品的sku信息（?method=app.limitProduct.userChoiceSku）
  4 +#### 公共请求参数
  5 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  6 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  7 +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
  8 +|app_version|float|10|否|1||APP版本|
  9 +|os_version|string|20|否|Android4.4||系统版本+机器型号|
  10 +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|
  11 +|screen_size|string|20|否|800x900||（手机尺寸）|
  12 +#### 请求参数
  13 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  14 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  15 +|uid|String|否|1-11|3566164||用户id|
  16 +|product_skn|String|否|1-11|50001796||skn|
  17 +|product_sku|String|否|1-11|102034||sku|
  18 +|product_skc|String|否|1-11|14||skc|
  19 +|color_name|String|否|1-50|黑||颜色|
  20 +|size_name|String|否|1-20|L||尺码|
  21 +|activity_id|String|否|1-5|111||活动id|
  22 +#### 接口说明
  23 +| 接口说明||
  24 +|:-------| -----:|
  25 +|请求域名|http://api.yoho.cn|
  26 +|接口名|app.limitProduct.userChoiceSku|
  27 +|接口说明|用户选择/修改活动商品的sku信息|
  28 +|http请求方式|POST/GET|
  29 +#### 返回错误
  30 +|错误code|错误提示|
  31 +|:-------| -----:|
  32 +|500|活动id为空|
  33 +|500|活动已结束，不可以修改颜色尺码|
  34 +|500|uid或productSkn不能为空|
  35 +|500|选择颜色尺码失败|
  36 +
  37 +注意，通用的头部没有列出。
  38 +请求示例
  39 +http://192.168.102.205:8080/gateway?uid=8039796&v=7&method=app.limitProduct.userChoiceSku&activity_id=111&uid=3566164&product_skn=50001796&product_sku=102034&product_skc=14&size_name=L&color_name=黑
  40 +### 响应
  41 +code为200即为成功，否则是失败。
  42 +响应参数，data部分
  43 +响应成功JSON格式如下所示:
  44 +```json
  45 +{
  46 + "code": 200,
  47 + "message": "成功",
  48 + "md5": "6d729d4b35f10fc73531210bd7ecff91",
  49 + "alg": "SALT_MD5",
  50 + "data": []
  51 +}
  52 +```
  53 +响应失败JSON格式如下所示:
  54 +```json
  55 +{
  56 + "code": 500,
  57 + "message": "活动id为空",
  58 + "md5": "6d729d4b35f10fc73531210bd7ecff91",
  59 + "alg": "SALT_MD5",
  60 + "data": []
  61 +}
  62 +```
  63 +```json
  64 +{
  65 + "code": 500,
  66 + "message": "活动已结束,不可以修改颜色尺码",
  67 + "md5": "6d729d4b35f10fc73531210bd7ecff91",
  68 + "alg": "SALT_MD5",
  69 + "data": []
  70 +}
  71 +```
  72 +
  73 +```json
  74 +{
  75 + "code": 500,
  76 + "message": "uid或productSkn不能为空",
  77 + "md5": "6d729d4b35f10fc73531210bd7ecff91",
  78 + "alg": "SALT_MD5",
  79 + "data": []
  80 +}
  81 +```
  82 +```json
  83 +{
  84 + "code": 500,
  85 + "message": "选择颜色尺码信息失败",
  86 + "md5": "6d729d4b35f10fc73531210bd7ecff91",
  87 + "alg": "SALT_MD5",
  88 + "data": []
  89 +}
  90 +```
  91 +
  92 +## 3、根据skn获取平台配置的sku的商品详细信息 ##
  93 +根据skn获取平台配置的sku的商品详细信息（?method=app.limitProduct.getLimitProductDataBySkn）
  94 +#### 公共请求参数
  95 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  96 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  97 +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
  98 +|app_version|float|10|否|1||APP版本|
  99 +|os_version|string|20|否|Android4.4||系统版本+机器型号|
  100 +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|
  101 +|screen_size|string|20|否|800x900||（手机尺寸）|
  102 +#### 请求参数
  103 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  104 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  105 +|product_skn|String|否|1-11|50001796||用户id|
  106 +#### 接口说明
  107 +| 接口说明||
  108 +|:-------| -----:|
  109 +|请求域名|http://api.yoho.cn|
  110 +|接口名|app.limitProduct.getLimitProductDataBySkn|
  111 +|接口说明|获取平台配置的sku的商品详细信息|
  112 +|http请求方式|POST/GET|
  113 +
  114 +#### 返回错误
  115 +|错误code|错误提示|
  116 +|:-------| -----:|
  117 +|500|product_skn不能为空|
  118 +|500|找不到商品对应的颜色尺码信息|
  119 +
  120 +注意，通用的头部没有列出。
  121 +请求示例
  122 +http://192.168.102.205:8080/gateway?method=app.limitProduct.getLimitProductDataBySkn&debug=XYZ&product_skn=50001796
  123 +
  124 +### 响应
  125 +code为200即为成功，否则是失败。
  126 +响应参数，data部分
  127 +响应成功JSON格式如下所示:
  128 +```json
  129 +{
  130 + "alg": "SALT_MD5",
  131 + "code": 200,
  132 + "data": {
  133 + "cn_alphabet": "",
  134 + "format_market_price": "¥275.00",
  135 + "format_sales_price": "0",
  136 + "goods_list": [
  137 + {
  138 + "color_id": 2,
  139 + "color_image": "http://img13.static.yhbimg.com/goodsimg/2012/03/02/17/0242814e14d8ac1525c92de0a84d0f70eb.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  140 + "color_name": "黑",
  141 + "goods_id": 14,
  142 + "images_list": [ ],
  143 + "is_default": "N",
  144 + "product_skc": 14,
  145 + "size_list": [
  146 + {
  147 + "order_by": 1169,
  148 + "product_sku": 102050,
  149 + "size_id": 201,
  150 + "size_name": "L",
  151 + "storage_number": 0
  152 + },
  153 + {
  154 + "order_by": 1163,
  155 + "product_sku": 102034,
  156 + "size_id": 211,
  157 + "size_name": "XL",
  158 + "storage_number": 0
  159 + }
  160 + ],
  161 + "status": 1
  162 + },
  163 + {
  164 + "color_id": 3,
  165 + "color_image": "http://img11.static.yhbimg.com/goodsimg/2012/03/02/15/01562d80dbd0f5acc9e8b96668836006ff.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  166 + "color_name": "灰",
  167 + "goods_id": 15,
  168 + "images_list": [ ],
  169 + "is_default": "Y",
  170 + "product_skc": 15,
  171 + "size_list": [
  172 + {
  173 + "order_by": 1175,
  174 + "product_sku": 102037,
  175 + "size_id": 203,
  176 + "size_name": "M",
  177 + "storage_number": 0
  178 + },
  179 + {
  180 + "order_by": 1169,
  181 + "product_sku": 102050,
  182 + "size_id": 201,
  183 + "size_name": "L",
  184 + "storage_number": 0
  185 + },
  186 + {
  187 + "order_by": 1163,
  188 + "product_sku": 102034,
  189 + "size_id": 211,
  190 + "size_name": "XL",
  191 + "storage_number": 0
  192 + }
  193 + ],
  194 + "status": 1
  195 + }
  196 + ],
  197 + "info": {
  198 + "comment_total": 0,
  199 + "consult_total": 0
  200 + },
  201 + "isLimitBuy": false,
  202 + "is_advance": "",
  203 + "is_collect": "",
  204 + "is_outlets": "",
  205 + "limitProductCode": "",
  206 + "market_price": 275,
  207 + "phrase": "OVERKILL OVK 08 CUTE SKULL 短袖TEE.正面胸口的图案和背后相互呼应，清新活力。超炫的骷髅图案，带来不一样的靓点 ",
  208 + "product_name": "OVERKILL OVK 08 CUTE SKULL 短袖TEE",
  209 + "product_skn": 50001796,
  210 + "product_url": "",
  211 + "saleStatus": 0,
  212 + "sales_phrase": "275",
  213 + "sales_price": 275,
  214 + "showStatus": 0,
  215 + "storage_sum": 0,
  216 + "vip": [
  217 + {
  218 + "caption": "银卡",
  219 + "price": "261.25"
  220 + },
  221 + {
  222 + "caption": "金卡",
  223 + "price": "247.50"
  224 + },
  225 + {
  226 + "caption": "白金",
  227 + "price": "242.00"
  228 + }
  229 + ],
  230 + "vip_price": "0.00",
  231 + "yohoCoinNum": "0"
  232 + },
  233 + "md5": "bc08c52373b36a0578293aa334176879",
  234 + "message": "success!"
  235 +}
  236 +```
  237 +## 4、参加SKU排队活动时检测APP版本号##
  238 +参加SKU排队活动时检测APP版本号（method=app.drawline.addQueue）
  239 +#### 公共请求参数
  240 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  241 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  242 +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
  243 +|app_version|float|10|否|1||APP版本|
  244 +|os_version|string|20|否|Android4.4||系统版本+机器型号|
  245 +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|
  246 +|screen_size|string|20|否|800x900||（手机尺寸）|
  247 +#### 请求参数
  248 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  249 +|:-------| -----:|-----:|-----:|-----:|----:|----:|
  250 +|activityId|Integer|1-5|否||无|活动id|
  251 +|app_version|String|1-10|否||无|版本号|
  252 +|uid|Integer|1-10|否||无||
  253 +|userType|Byte|1|是|1,2|1|用户类型(1真实用户，2马甲用户)|
  254 +|sort|Integer|1-7|是|||排队序号|
  255 +|limit|Integer|1-3|是|||分页大小|
  256 +#### 接口说明
  257 +| 接口说明||
  258 +|:-------| -----:|
  259 +|请求域名|http://api.yoho.cn|
  260 +|接口名|app.drawline.addQueue|
  261 +|接口说明|参加SKU排队活动时检测APP版本号息|
  262 +|http请求方式|POST/GET|
  263 +
  264 +注意，通用的头部没有列出。
  265 +请求示例http://127.0.0.1:8090/activity/?method=app.drawline.addQueue&app_version=4.0.1&uid=109&activityId=11
  266 +
  267 +### 响应
  268 +code为200即为成功，否则是失败。
  269 +响应JSON格式如下所示:
  270 +```json
  271 +{
  272 + "code": 900001006,
  273 + "message": "版本过低，请更新",
  274 + "md5": "f4a7a490bb6666b005008d795ed14e5d",
  275 + "alg": "SALT_MD5",
  276 + "data": {}
  277 +}
  278 +```
  279 +## 5、我的限购码##
  280 +我的限购码（method=app.limitcode.query）
  281 +#### 公共请求参数
  282 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  283 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  284 +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
  285 +|app_version|float|10|否|1||APP版本|
  286 +|os_version|string|20|否|Android4.4||系统版本+机器型号|
  287 +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|
  288 +|screen_size|string|20|否|800x900||（手机尺寸）|
  289 +#### 请求参数
  290 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  291 +|:-------| -----:|-----:|-----:|-----:|----:| ----:|
  292 +|uid|int|1-10|否||无|用户id|
  293 +#### 接口说明
  294 +| 接口说明||
  295 +|:-------| -----:|
  296 +|请求域名|http://api.yoho.cn|
  297 +|接口名|app.limitcode.query|
  298 +|接口说明|我的限购码|
  299 +|http请求方式|POST/GET|
  300 +
  301 +注意，通用的头部没有列出。
  302 +请求示例http://127.0.0.1:8080/gateway/?method=app.limitcode.query&uid=12710899
  303 +
  304 +### 响应
  305 +code为200即为成功，否则是失败。
  306 +```json
  307 +{
  308 + "alg": "SALT_MD5",
  309 + "code": 200,
  310 + "data": {
  311 + "invalidLimitCodeProducts": [],
  312 + "limitCodeProducts": [{
  313 +"defaultUrl":"http://img11.static.yhbimg.com/goodsimg/2016/04/15/11/011c20479a68be0e4ef15cca3b2ce89f6d.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  314 +"limitCode":"2aD3U14L2",
  315 +"limitProductCode":"2016041511502657",
  316 +"price":"¥1499.00",
  317 +"productName":"大牌合作超强联手PUMA x McQ Brace Mid black强势来袭",
  318 +"productSkn":"51162585",
  319 +"productSku":"578965",
  320 +"color_name":"黑色"，
  321 +"size_name":"42码",
  322 +"status":"1"
  323 +}]
  324 + },
  325 + "md5": "3023b84ee63d9ea554cbbd0bf40fef62",
  326 + "message": "操作成功"
  327 +}
  328 +```
  329 +
  330 +## 6、限定商品详情##
  331 +限定商品详情（method=app.limitProduct.limitProductDetail）
  332 +#### 公共请求参数
  333 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  334 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  335 +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
  336 +|app_version|float|10|否|1||APP版本|
  337 +|os_version|string|20|否|Android4.4||系统版本+机器型号|
  338 +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|
  339 +|screen_size|string|20|否|800x900||（手机尺寸）|
  340 +#### 请求参数
  341 +| 参数名称 | 参数类型 |长度 | 可否为空 | 示例 | 默认值 | 备注 |
  342 +|:-------| -----:|-----:|-----:|-----:|----:| ----:|
  343 +|uid|int|1-10|是||0|用户id|
  344 +|limitProductCode|String|1-20|否||无||
  345 +#### 接口说明
  346 +| 接口说明||
  347 +|:-------| -----:|
  348 +|请求域名|http://api.yoho.cn|
  349 +|接口名|app.limitProduct.limitProductDetail|
  350 +|接口说明|限定商品详情|
  351 +|http请求方式|POST/GET|
  352 +
  353 +注意，通用的头部没有列出。
  354 +请求示例http://127.0.0.1:8080/gateway/?method=app.limitProduct.limitProductDetail&uid=12710899&limitProductCode=2016022420292150
  355 +
  356 +### 响应
  357 +code为200即为成功，否则是失败。
  358 +```json
  359 +{
  360 + "alg": "SALT_MD5",
  361 + "code": 200,
  362 + "data":
  363 + {"alertFlag":true,
  364 +"attachment":
  365 +[{"attachName":"",
  366 +"attachType":1,
  367 +"attachUrl":"",
  368 +"id":25197,
  369 +"intro":"",
  370 +"isDefault":1,
  371 +"orderBy":1,
  372 +"productId":167,
  373 +"status":0},
  374 +"batchNo":"2016040718244343",
  375 +"defaultUrl":"http://img12.static.yhbimg.com/goodsimg/2016/04/19/11/028199c467efae8038f9705534c8277225.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  376 +"description":"",
  377 +"hotFlag":1,
  378 +"id":167,
  379 +"limitProductCode":"2016041911341815",
  380 +"limitProductType":1,
  381 +"oldSaleTime":1461297600,
  382 +"orderBy":9,
  383 +"colorName":"黑色",
  384 +"sizeName":"42码",
  385 +"selectSKU":"51187",
  386 +"relatedSKU":true,
  387 +"queueType":"1",
  388 +"price":"¥1099.00",
  389 +"productName":"大牌合作超强联手PUMA x McQ Brace Lo Femme White",
  390 +"productSkn":51162584,
  391 +"reminderNum":22702,
  392 +"saleStatus":0,
  393 +"saleTime":"2016年4月22日",
  394 +"shareUrl":"http://m.yohobuy.com/product/detail/limit?code=2016041911341815",
  395 +"showFlag":1,
  396 +"showStatus":6},
  397 +"md5":"19d342768d9ec4db0ab21bb5d96430df",
  398 +"message":"detail limitproduct info"
  399 +}
  400 +```