README.md



1、订阅降价通知接口

订阅降价通知接口（method=web.redution.add）


请求参数


参数名称
参数类型
可否为空
示例
默认值
备注


uid
int
否
213
0
用户id


mobile
string
否
13211111111
0
手机号码


productId
int
否
214217
0
商品id


注意，通用的头部没有列出。

请求示例
http://devapi.yoho.cn:58078/?app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=web.redution.add&uid=8040274&mobile=13211111111&productId=214217&client_secret=e1a7a55c91db35c3f494e39c650de8dc


响应(data里所有的字段返回都是string类型)

code为200即为成功，否则是失败。 
响应JSON格式如下所示:

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": {
        "num": 1,
        "product_skns": [
            214217
        ]
    },
    "md5": "77c2e3eb2763ac40dbb667d54781dd9b",
    "message": "操作成功"
}


2、取消订阅降价通知接口

取消订阅降价通知接口（method=web.redution.cancel）


请求参数


参数名称
参数类型
可否为空
示例
默认值
备注


uid
int
否
213
0
用户id


productIds
int
否
214217,214217
0
商品id


注意，通用的头部没有列出。

请求示例
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=web.redution.cancel&uid=8040274&productIds=119277&client_secret=3f31be8d35adb60425882cbb7298afa9


响应(data里所有的字段返回都是string类型)

code为200即为成功，否则是失败。 
响应JSON格式如下所示:

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": {
        "num": 1
    },
    "md5": "77c2e3eb2763ac40dbb667d54781dd9b",
    "message": "操作成功"
}


3、查询订阅降价数量接口

查询订阅降价数量接口（method=web.redution.count）


请求参数


参数名称
参数类型
可否为空
示例
默认值
备注


uid
int
否
213
0
用户id


注意，通用的头部没有列出。

请求示例
http://devapi.yoho.cn:58078/?debug=XYZ&method=web.redution.count&uid=706730&v=7


响应(data里所有的字段返回都是string类型)

code为200即为成功，否则是失败。 
响应JSON格式如下所示:

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": {
        "num": 1
    },
    "md5": "77c2e3eb2763ac40dbb667d54781dd9b",
    "message": "操作成功"
}


4、用户VIP信息

用户VIP信息（method=app.passport.vip）


公共请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


client_secret
string
50
否
5ac68f20cb18efe154be

进入接口提供的参数加密信息


app_version
float
10
否
1

APP版本


os_version
string
20
否
Android4.4

系统版本+机器型号


client_type
string
20
否
iphone/android/ipad

手机型号（不区分大小写）


screen_size
string
20
否
800x900

（手机尺寸）


请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


uid
String
64
否
123587
空白
uid


注意，通用的头部没有列出。 
请求示例

http://127.0.0.1:8080/gateway?app_version=4.3.0.1605090001&client_type=android&method=app.passport.vip&os_version=9.3.1&uid=4372&screen_size=375x667&v=7&yh_channel=1


响应

code为200即为成功，否则是失败。 
响应参数，data部分

响应成功JSON格式如下所示:

{
  "alg": "SALT_MD5",
  "code": 200,
  "data": {
    "current_total_cost": "0.00",
    "next_vip_level": "3",
    "current_year_cost": "0.00",
    "vip_end_time": "1425714071",
    "upgrade_need_cost": "5000.0",
    "vip_start_time": "1394178071",
    "current_vip_level": "2",
    "enjoy_preferential": [
      {
        "description": "在原折扣基础上享受VIP折上折",
        "id": 2,
        "pic": "http://static.yohobuy.com/images/app/icon_2x_zhekou.png",
        "title": "金卡会员购物9.0折"
      },
      {
        "description": "年度级的sale促销活动中，VIP会员可以享受优先购买权",
        "id": 4,
        "pic": "http://static.yohobuy.com/images/app/icon_2x_niandu.png",
        "title": "年度活动优惠"
      },
      {
        "description": "参加\"VIP会员限定\"活动",
        "id": 10,
        "pic": "http://static.yohobuy.com/images/app/icon_2x_vip.png",
        "title": "VIP活动优惠"
      },
      {
        "description": "白金卡会员的订单将采用最快速度进行免费配送，金卡会员的订单免费配送",
        "id": 5,
        "pic": "http://static.yohobuy.com/images/app/icon_2x_kssd.png",
        "title": "快速送达"
      },
      {
        "description": "赠送生日优惠券",
        "id": 8,
        "pic": "http://static.yohobuy.com/images/app/icon_2x_sryh.png",
        "title": "生日特惠"
      },
      {
        "description": "获取大量潮流新品及优惠活动的信息",
        "id": 9,
        "pic": "http://static.yohobuy.com/images/app/icon_2x_yhxx.png",
        "title": "优惠信息"
      }
    ],
    "next_vip_title": "白金会员",
    "vip_reach_time": "1392882071",
    "current_vip_title": "金卡会员",
    "next_need_cost": 5000
  },
  "md5": "765197229fb0b19986a28680a9bf6b8c",
  "message": "vip."
}


5、vip累计记录

vip累计记录（method=app.passport.getVipRecord）


公共请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


client_secret
string
50
否
5ac68f20cb18efe154be

进入接口提供的参数加密信息


app_version
float
10
否
1

APP版本


os_version
string
20
否
Android4.4

系统版本+机器型号


client_type
string
20
否
iphone/android/ipad

手机型号（不区分大小写）


screen_size
string
20
否
800x900

（手机尺寸）


请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


uid
String
64
否
12710899
空
uid


startTime
int
64
是
1474408802
空
查询开始时间


endTime
int
64
是
1474408804
空
查询结束时间


limit
String
60
是
10
空白
每页数量


page
String
10
是
1
空白
第几页


注意，通用的头部没有列出。 
请求示例 
http://127.0.0.1:8080/gateway?app_version=4.3.0.1605090001&client_type=android&method=app.passport.getVipRecord&os_version=9.3.1&uid=4033466&screen_size=375x667&v=7&yh_channel=1&debug=XYZ


响应

code为200即为成功，否则是失败。 
响应参数，data部分

响应成功JSON格式如下所示:

{
  "alg": "SALT_MD5",
  "code": 200,
  "data": {
    "list": [
      {
        "uid": 4033466,
        "initOrderCode": 310517909,
        "totalAmount": -105,
        "amount": -105,
        "times": 1,
        "createTime": 1450342186,
        "orderCode": 310517909,
        "id": 11,
        "type": "退货",
        "happenTime": 1383547382
      }
    ],
    "page": 1,
    "pageSize": 10,
    "page_total": 1,
    "total": 1
  },
  "md5": "07703596f3b47a7705738ebaba782911",
  "message": "success"
}


9、用户列表，可以根据手机号、用户UID和邮箱地址进行搜索

用户列表（method=app.passport.getProfileByUidOrEamilOrMobile）
|:-------| -----:|-----:|-----:|-----:|-----:|----:| 
|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
|app_version|float|10|否|1||APP版本|
|os_version|string|20|否|Android4.4||系统版本+机器型号|
|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|
|screen_size|string|20|否|800x900|（手机尺寸）|


请求参数


参数名称
参数类型
长度
可否为空
示例
默认值
备注


uids
String
64
是
12710899,123
空白
uid列表,用,分割


area
String
64
是
86
86
国家码


mobile
String
是
15051889346

手机号码


email
String
64
是


邮箱，手机，uid三者不能同时为空


limit
String
60
是
10
空白
每页数量


page
String
10
是
1
空白
第几页


注意，通用的头部没有列出。 
请求示例 
http://127.0.0.1:8080/gateway/?app_version=4.6.0&client_type=h5&method=app.passport.getProfileByUidOrEamilOrMobile&os_version=yohobuy%3Ah5&uid=20000718&mobile=15051889346


响应

code为200即为成功，否则是失败。 
响应参数，data部分

响应成功JSON格式如下所示:

{
  "alg": "SALT_MD5",
  "code": 200,
  "data": {
{
  "page_total": 1,
  "total": 2,
  "pageSize": 10,
  "page": 1,
  "list": [
    {
      "profile_name": null,
      "uid": 11033,
      "username": null,
      "nickname": null,
      "gender": null,
      "birthday": null,
      "head_ico": null,
      "income": null,
      "profession": null,
      "mobile": null,
      "email": "lu8092@sina.com",
      "verify_email": null,
      "verify_mobile": null,
      "yoho_currency": 0,
      "createTime": 1309107674,
      "vip_info": null,
      "qq_nickname": "",
      "qq_bind": "N",
      "wechat_nickname": "",
      "wechat_bind": "N",
      "sina_nickname": "",
      "sina_bind": "N",
      "alipay_nickname": "",
      "alipay_bind": "N",
      "height": "",
      "weight": "",
      "bind_gate": ""
    },
    {
      "profile_name": null,
      "uid": 11037,
      "username": null,
      "nickname": null,
      "gender": null,
      "birthday": null,
      "head_ico": null,
      "income": null,
      "profession": null,
      "mobile": null,
      "email": "fbi_wangshen123@163.com",
      "verify_email": null,
      "verify_mobile": null,
      "yoho_currency": 0,
      "createTime": 1309107674,
      "vip_info": null,
      "qq_nickname": "",
      "qq_bind": "N",
      "wechat_nickname": "",
      "wechat_bind": "N",
      "sina_nickname": "",
      "sina_bind": "N",
      "alipay_nickname": "",
      "alipay_bind": "N",
      "height": "",
      "weight": "",
      "bind_gate": ""
    }
  ]
}

  },
  "md5": "5f182e1202a2026d0dd638af7f8c8048",
  "message": "yoho coin total"
}


10、重置密码

重置密码（method=erp.reset.password）


请求参数


参数名称
参数类型
可否为空
示例
默认值
备注


uid
int
否
213
0
用户id


newPassword
String
否
123456
0
新密码


注意，通用的头部没有列出。

请求示例
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=erp.reset.password&uid=8040274&newPassword=123456


响应(data里所有的字段返回都是string类型)

code为200即为成功，否则是失败。 
响应JSON格式如下所示:

{
    "alg": "SALT_MD5",
    "code": 200,
    "md5": "77c2e3eb2763ac40dbb667d54781dd9b",
    "message": "success"
}