匡佳华 / API-Interfaces · Commits

Go to a project

Authored by gezhengwen
Commit 35a663d8c7d9c85b07f0102d91843e2e4c8835b1 1 parent 3cdaf50f

Add new file

Inline Side-by-side
Showing 1 changed file with 439 additions and 0 deletions
  1 +1.查询各个体系成长等级信息及等级特权（目前仅mars与有货buy）
  2 +接口url：method=app.yohofamily.getVipInfo
  3 +入参：无
  4 +出参：
  5 +{
  6 + "alg": "SALT_MD5",
  7 + "code": 200,
  8 + "data": {
  9 + "mars": { ------mars成长规则
  10 + "vipLevelList": [
  11 + {
  12 + "growthValue": 100, -----下一级成长值
  13 + "level": 0, -----当前级别
  14 + "levelImg": "http://img01.yohomars.com/mars/2017/01/24/d1f9cb68a1e7aae4a1a6c4eeca7b1b0e.png?imageView/{mode}/w/{width}/h/{height}", ---级别图片
  15 + "marsPointDiscount": 100 -----积分换购折扣率
  16 + },
  17 + {
  18 + "growthValue": 400,
  19 + "level": 1,
  20 + "levelImg": "http://img01.yohomars.com/mars/2017/01/24/5336ef84190a715bd221fca50a9e9e3d.png?imageView/{mode}/w/{width}/h/{height}",
  21 + "marsPointDiscount": 100
  22 + },
  23 + {
  24 + "growthValue": 1000,
  25 + "level": 2,
  26 + "levelImg": "http://img01.yohomars.com/mars/2017/01/24/1027321fcaf5311ab21963f925ecb0dd.png?imageView/{mode}/w/{width}/h/{height}",
  27 + "marsPointDiscount": 95,
  28 + "privilege": "mars points 9.5折兑换"
  29 + },
  30 + {
  31 + "growthValue": 2000,
  32 + "level": 3,
  33 + "levelImg": "http://img01.yohomars.com/mars/2017/01/24/e4512e2c5e78140170bf4967c4368645.png?imageView/{mode}/w/{width}/h/{height}",
  34 + "marsPointDiscount": 90,
  35 + "privilege": "mars points 9折兑换" ---特权中文描述
  36 + },
  37 + {
  38 + "growthValue": 5000,
  39 + "level": 4,
  40 + "levelImg": "http://img01.yohomars.com/mars/2017/01/24/312d0b334370eb8a9711065d489451ca.png?imageView/{mode}/w/{width}/h/{height}",
  41 + "marsPointDiscount": 85,
  42 + "privilege": "mars points 8.5折兑换"
  43 + },
  44 + {
  45 + "growthValue": 10000,
  46 + "level": 5,
  47 + "levelImg": "http://img01.yohomars.com/mars/2017/01/24/148be1f69f64ebc1872c43b5b4b7e620.png?imageView/{mode}/w/{width}/h/{height}",
  48 + "marsPointDiscount": 80,
  49 + "privilege": "mars points 8折兑换"
  50 + }
  51 + ]
  52 + },
  53 + "yohobuy": {
  54 + "privilegeList": [ ---有货buy特权列表
  55 + {
  56 + "description": "在原折扣基础上享受VIP折上折", ---特权中文描述
  57 + "id": 1, ---特权ID
  58 + "pic": "http://static.yohobuy.com/images/app/icon_2x_zhekou.png", ---特权图片
  59 + "title": "银卡会员购物9.5折" ---特权说明
  60 + },
  61 + {
  62 + "description": "在原折扣基础上享受VIP折上折",
  63 + "id": 2,
  64 + "pic": "http://static.yohobuy.com/images/app/icon_2x_zhekou.png",
  65 + "title": "金卡会员购物9.0折"
  66 + },
  67 + {
  68 + "description": "在原折扣基础上享受VIP折上折",
  69 + "id": 3,
  70 + "pic": "http://static.yohobuy.com/images/app/icon_2x_zhekou.png",
  71 + "title": "白金卡会员购物8.8折"
  72 + },
  73 + {
  74 + "description": "年度级的sale促销活动中，VIP会员可以享受优先购买权",
  75 + "id": 4,
  76 + "pic": "http://static.yohobuy.com/images/app/icon_2x_niandu.png",
  77 + "title": "年度活动优惠"
  78 + },
  79 + {
  80 + "description": "白金卡会员的订单将采用最快速度进行免费配送，金卡会员的订单免费配送",
  81 + "id": 5,
  82 + "pic": "http://static.yohobuy.com/images/app/icon_2x_kssd.png",
  83 + "title": "快速送达"
  84 + },
  85 + {
  86 + "description": "浏览《YOHO!潮流志》、《YOHO!GIRL》电子版，最新最权威的潮流资讯尽在掌握！",
  87 + "id": 6,
  88 + "pic": "http://static.yohobuy.com/images/app/icon_2x_zzzy.png",
  89 + "title": "电子杂志赠阅"
  90 + },
  91 + {
  92 + "description": "赠送生日优惠券",
  93 + "id": 8,
  94 + "pic": "http://static.yohobuy.com/images/app/icon_2x_sryh.png",
  95 + "title": "生日特惠"
  96 + },
  97 + {
  98 + "description": "获取大量潮流新品及优惠活动的信息",
  99 + "id": 9,
  100 + "pic": "http://static.yohobuy.com/images/app/icon_2x_yhxx.png",
  101 + "title": "优惠信息"
  102 + },
  103 + {
  104 + "description": "参加\"VIP会员限定\"活动",
  105 + "id": 10,
  106 + "pic": "http://static.yohobuy.com/images/app/icon_2x_vip.png",
  107 + "title": "VIP活动优惠"
  108 + }
  109 + ],
  110 + "vipLevelList": [ ----有货成长等级列表
  111 + {
  112 + "growthValue": 0, ----当前等级最低成长值
  113 + "level": 0,
  114 + "name": "普通会员", ----当前等级中文描述
  115 + "privilege": "" ----当前等级特权集合（对应特权id属性，多个特权时用,分割）
  116 + },
  117 + {
  118 + "growthValue": 600,
  119 + "level": 1,
  120 + "name": "银卡会员",
  121 + "privilege": "1,4,10,6,8,9"
  122 + },
  123 + {
  124 + "growthValue": 2000,
  125 + "level": 2,
  126 + "name": "金卡会员",
  127 + "privilege": "2,4,10,5,6,8,9"
  128 + },
  129 + {
  130 + "growthValue": 5000,
  131 + "level": 3,
  132 + "name": "白金会员",
  133 + "privilege": "3,4,10,5,6,8,9"
  134 + }
  135 + ]
  136 + }
  137 + },
  138 + "md5": "c4b412c1c537dda372158cdc3def5669",
  139 + "message": "操作成功"
  140 +}
  141 +
  142 +
  143 +2.查询当前用户各个体系成长等级信息及等级特权（目前仅mars与有货buy）
  144 +接口url：method=app.yohofamily.getUserVipInfo
  145 +入参：uid 用户ID
  146 +出参：
  147 +{
  148 + "alg": "SALT_MD5",
  149 + "code": 200,
  150 + "data": {
  151 + "mars": { ----当前用户mars成长信息
  152 + "growthValue": 2000, ----当前成长值
  153 + "level": 4, ----当前级别
  154 + "nextLevel": 5, ----下一级别
  155 + "privilege": "mars points 8.5折兑换", ----当前等级特权
  156 + "valueToNextLevel": 3000 ----距离下一等级的成长值
  157 + },
  158 + "yohobuy": { ----当前有货buy用户成长信息
  159 + "growthValue": 1500, ----当前成长值
  160 + "level": 1, ----当前级别
  161 + "name": "银卡会员", ----当前级别中文
  162 + "nextLevel": 2, ----下一级别
  163 + "valueToNextLevel": 500, ----距离下一等级的成长值
  164 + "privilege": [ ----当前等级特权列表
  165 + {
  166 + "description": "在原折扣基础上享受VIP折上折",
  167 + "id": 1,
  168 + "pic": "http://static.yohobuy.com/images/app/icon_2x_zhekou.png",
  169 + "title": "银卡会员购物9.5折"
  170 + },
  171 + {
  172 + "description": "年度级的sale促销活动中，VIP会员可以享受优先购买权",
  173 + "id": 4,
  174 + "pic": "http://static.yohobuy.com/images/app/icon_2x_niandu.png",
  175 + "title": "年度活动优惠"
  176 + },
  177 + {
  178 + "description": "浏览《YOHO!潮流志》、《YOHO!GIRL》电子版，最新最权威的潮流资讯尽在掌握！",
  179 + "id": 6,
  180 + "pic": "http://static.yohobuy.com/images/app/icon_2x_zzzy.png",
  181 + "title": "电子杂志赠阅"
  182 + },
  183 + {
  184 + "description": "赠送生日优惠券",
  185 + "id": 8,
  186 + "pic": "http://static.yohobuy.com/images/app/icon_2x_sryh.png",
  187 + "title": "生日特惠"
  188 + },
  189 + {
  190 + "description": "获取大量潮流新品及优惠活动的信息",
  191 + "id": 9,
  192 + "pic": "http://static.yohobuy.com/images/app/icon_2x_yhxx.png",
  193 + "title": "优惠信息"
  194 + },
  195 + {
  196 + "description": "参加\"VIP会员限定\"活动",
  197 + "id": 10,
  198 + "pic": "http://static.yohobuy.com/images/app/icon_2x_vip.png",
  199 + "title": "VIP活动优惠"
  200 + }
  201 + ]
  202 + }
  203 + },
  204 + "md5": "5ad00d2feaf58e202c4dcf8a972a37d9",
  205 + "message": "操作成功"
  206 +}
  207 +
  208 +
  209 +1.按app类型查询对应积分商城商品（目前仅mars和now）
  210 +接口url：method=app.yohofamily.getCoinShopGoods
  211 +入参：type 类型mars或者now
  212 + uid 用户ID
  213 + page 分页查询当前页
  214 + limit 分页查询每页数量
  215 +出参：
  216 +{
  217 + "alg": "SALT_MD5",
  218 + "code": 200,
  219 + "data": {
  220 + "page": 1, ---当前页
  221 + "pageSize": 10, ---当前每页数量
  222 + "total": 16, ---总数
  223 + "page_total": 2, ---总页数
  224 + "list": [ ---返回具体商品列表，mars与now返回字段有所不同，请注意区分
  225 +
  226 + mars返回对象
  227 + {
  228 + "name":"50 元话费充值", ---商品名称
  229 + "headPic":"http://img01.yohomars.com/mars/2016/07/27/277e6c8be0de9049d37851b7da3af107.jpg?imageView/{mode}/w/{width}/h/{height}", ---商品头图
  230 + "points": 10000, ---需要积分
  231 + "num":500, ---剩余库存
  232 + "startTime": 1497196800, ---兑换开始时间，0表示无限制
  233 + "endTime": 1497196800, ---兑换结束时间，0表示无限制
  234 + "level": 0, ---兑换等级限制
  235 + "discountPoints": 9000 ---折扣后需要的积分
  236 + }
  237 +
  238 + now返回对象
  239 + {
  240 + "name":"50 元话费充值", ---商品名称
  241 + "headimg":"http://img01.yohomars.com/mars/2016/07/27/277e6c8be0de9049d37851b7da3af107.jpg?imageView/{mode}/w/{width}/h/{height}", ---商品头图
  242 + "point": 10000, ---需要积分
  243 + "stock":500, ---剩余库存
  244 + "offlineTime": 1497196800 ---下线时间
  245 + }
  246 + ]
  247 + },
  248 + "md5": "5ad00d2feaf58e202c4dcf8a972a37d9",
  249 + "message": "操作成功"
  250 +}
  251 +
  252 +
  253 +## 1、获取这个用户各个系统的登录情况##
  254 +获取这个用户各个系统的登录情况（app.yohofamily.geyLoginMessage）
  255 +
  256 +#### 请求参数 get
  257 +| 参数名称 | 参数类型 |长度| 可否为空 | 示例 | 默认值 | 备注 |
  258 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  259 +|uid|int|1-11|否|802654|||
  260 +
  261 +http://192.168.103.73:8080/gateway/?method=app.yohofamily.geyLoginMessage&os_version=yohobuy%3Ah5&screen_size=720x1280&session_key=d020d2a12276c583bd11b111439eb985&uid=34&v=7&mobile=13014896244&debug=XYZ&area=86&udid=862380036648114d527735aaec58acb
  262 +
  263 +响应JSON格式如下所示:
  264 +```json
  265 +{
  266 + code: 200,
  267 + message: "",
  268 + data: {
  269 + "uid": 34,
  270 + "yohobuy": 0,
  271 + "green": 1,
  272 + "mars": 1,
  273 + "now": 0,
  274 + "coffee": 0,
  275 + "life": 0
  276 + }
  277 +}
  278 +```
  279 +1代表这个uid曾经在这个app上登录过
  280 +
  281 +查询当前用户有货币流水明细
  282 +## 查询当前用户有货币流水明细##
  283 +(app.yohocoin.lists）
  284 +
  285 +#### 请求参数 get
  286 +| 参数名称 | 参数类型 |长度| 可否为空 | 示例 | 默认值 | 备注 |
  287 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  288 +|uid|int|1-11|否|802654|||
  289 +
  290 +http://127.0.0.1:8080/gateway/?method=app.yohocoin.lists&os_version=yohobuy%3Ah5&screen_size=720x1280&session_key=d020d2a12276c583bd11b111439eb985&uid=4284&v=7&mobile=13014896244&debug=XYZ&area=86&udid=862380036648114d527735aaec58acb&app_version=6.0.0
  291 +响应JSON格式如下所示:
  292 +```json
  293 +
  294 +{
  295 + "alg": "SALT_MD5",
  296 + "code": 200,
  297 + "data": {
  298 + "total": 2,
  299 + "page_total": 2,
  300 + "limit": 20,
  301 + "coinlist": [
  302 + {
  303 + "appSource": "Yoho!Buy有货",
  304 + "date": "2015-12-31 00:39:46",
  305 + "key": "2",
  306 + "message": "原有有货币2个，初始化变更",
  307 + "num": 200,
  308 + "type": 1
  309 + },
  310 + {
  311 + "appSource": "Yoho!Buy有货",
  312 + "date": "2015-12-21 19:18:40",
  313 + "key": "2",
  314 + "message": "原有有货币2个，初始化变更",
  315 + "num": 200,
  316 + "type": 1
  317 + }
  318 + ],
  319 + "page": 1
  320 + },
  321 + "md5": "e80c7b9d63375acfd123fcf8eff66339",
  322 + "message": "yoho coin list"
  323 +}
  324 +```json
  325 +
  326 +查询当前用户个人信息
  327 +## 3、查询当前用户个人信息##
  328 +
  329 +| 参数名称 | 参数类型 |长度| 可否为空 | 示例 | 默认值 | 备注 |
  330 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  331 +|uid|int|1-11|否|802654|||
  332 +
  333 +http://127.0.0.1:8080/gateway/?method=app.passport.profile&os_version=yohobuy%3Ah5&screen_size=720x1280&session_key=d020d2a12276c583bd11b111439eb985&uid=18108189&v=7&mobile=13014896244&debug=XYZ&area=86&udid=862380036648114d527735aaec58acb&app_version=6.0.0
  334 +
  335 +{
  336 + "alg": "SALT_MD5",
  337 + "code": 200,
  338 + "data": {
  339 + "alipay_bind": "N",
  340 + "alipay_nickname": "",
  341 + "bind_gate": "Y",
  342 + "birthday": "",
  343 + "createTime": 0,
  344 + "douban_bind": "N",
  345 + "douban_nickname": "",
  346 + "gender": "",
  347 + "head_ico": "",
  348 + "height": "",
  349 + "mobile": "",
  350 + "nickname": "18108189",
  351 + "profile_name": "18108189",
  352 + "qq_bind": "N",
  353 + "qq_nickname": "",
  354 + "renren_bind": "N",
  355 + "renren_nickname": "",
  356 + "sina_bind": "N",
  357 + "sina_nickname": "",
  358 + "uid": 18108189,
  359 + "username": "18108189",
  360 + "verify_email": "",
  361 + "verify_mobile": "",
  362 + "city":"江苏 南京"
  363 + "vip_info": {
  364 + "cur_level": "0",
  365 + "next_level": "1",
  366 + "title": "普通会员",
  367 + "nextVipTitle": "银卡会员",
  368 + "is_student": 0,
  369 + "upgrade_need_cost_str": "再消费￥800.0即可升级为银卡会员",
  370 + "curYearCost": "0",
  371 + "nextVipNeedCost": "800.0"
  372 + },
  373 + "wechat_bind": "N",
  374 + "wechat_nickname": "",
  375 + "weight": "",
  376 + "yoho_currency": 5
  377 + },
  378 + "md5": "b3795fa318e65f6aaf0019228dd4fec1",
  379 + "message": "请求成功"
  380 +}
  381 +
  382 +
  383 +## 1、修改个人信息##
  384 +
  385 +订阅降价通知接口（method=app.passport.modifyBase）
  386 +#### 请求参数
  387 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  388 +|:-------| -----:|-----:|-----:|-----:|----:|
  389 +|uid|int|否|213|0|用户id|
  390 +|nick_name|string|是||0|用户昵称|
  391 +|gender|String|是|2|0|性别|
  392 +|birthday|String|是|2|0|性别|
  393 +|height|Integer|是|2|0|身高|
  394 +|weight|Integer|是|2|0|体重|
  395 +|city|String|是||城市|
  396 +
  397 +注意，通用的头部没有列出。
  398 +请求示例
  399 +http://devapi.yoho.cn:58078/?app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=app.passport.modifyBase&uid=8040274&birthday=1999-1-1
  400 +
  401 +```json
  402 +
  403 +{
  404 + "alg": "SALT_MD5",
  405 + "code": 200,
  406 + "data"
  407 + "md5": "e80c7b9d63375acfd123fcf8eff66339",
  408 + "message":基本资料修改成功
  409 +}
  410 +```json
  411 +
  412 +## 1、查询当前用户各个体系有货币汇总##
  413 +
  414 +查询当前用户各个体系有货币汇总（method=app.yohofamily.yohocoin)
  415 +#### 请求参数
  416 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  417 +|:-------| -----:|-----:|-----:|-----:|----:|
  418 +|uid|int|否|213|0|用户id|
  419 +
  420 +
  421 +注意，通用的头部没有列出。
  422 +请求示例
  423 +http://devapi.yoho.cn:58078/?app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=app.yohofamily.yohocoin&uid=8040274&birthday=1999-1-1
  424 +
  425 +```json
  426 +{
  427 + code: 200,
  428 + message: "",
  429 + data: {
  430 + "uid": 8040274,
  431 + "yohobuyNum": 230,
  432 + "greenNum": 0,
  433 + "marsNum": 10,
  434 + "nowNum": 20,
  435 + "coffeeNum": 0,
  436 + "lifeNum": 0
  437 + }
  438 +}
  439 +```