匡佳华 / API-Interfaces · Files

Go to a project
README.md 11 KB

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"
}