tanling / API-Interfaces · Files

Go to a project
Find File
Name Last Update
..
PC.md Loading commit data...
README.md Loading commit data...
README.md

1、获取用户的验证信息

获取用户的验证信息（method=web.passport.getUserVerifyInfo）

请求参数

参数名称 参数类型 可否为空 示例 默认值 备注
uid string 否 123456 0 用户id

注意，通用的头部没有列出。
请求示例
http://127.0.0.1:8080/gateway?method=web.passport.getUserVerifyInfo&uid=12345

响应

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

参数名称 参数类型 示例 默认值 备注
email string 123@139.com 用户email
emailVerify string N 是否验证过邮箱(Y-是；N-否)
emailVerifyTime string 2015-01-01 12:00:00 验证邮箱时间
mobile string 13912345678 用户手机
mobileVerify string N 是否验证过手机(Y-是；N-否)
mobileVerifyTime string 2015-01-01 12:00:00 验证手机时间
uid int 6030455 用户id

用户响应JSON格式如下所示:

{
  "code": 200,
  "data": {
    "email": "123abc@139.com",
    "emailVerify": "N",
    "emailVerifyTime": "",
    "mobile": "",
    "mobileVerify": "Y",
    "mobileVerifyTime": "2015-11-13 14:14:35",
    "uid": 6030455
  },
  "message": "操作成功"
}

2、验证密码是否正确

验证密码是否正确（method=web.passport.verifyUserPwd）

请求参数

参数名称 参数类型 可否为空 示例 默认值 备注
uid string 否 123456 0 用户id
password string 否 123456 0 用户密码

注意，通用的头部没有列出。
请求示例
http://127.0.0.1:8080/gateway?method=web.passport.verifyUserPwd&uid=12345&password=1234567

响应

code为200即为成功，否则是失败。

用户响应JSON格式如下所示:

{
  "code": 200,
  "data": {
    "code": 200,
    "message": "success."
  },
  "message": "操作成功"
}

3、修改当前账号密码

修改当前账号密码（method=web.passport.changePwd）

请求参数

参数名称 参数类型 可否为空 示例 默认值 备注
uid string 否 123456 0 用户id
newPassword string 否 123456 0 用户新密码

注意，通用的头部没有列出。
请求示例
http://127.0.0.1:8080/gateway?method=web.passport.changePwd&uid=12345&newPassword=1234567

响应

code为200即为成功，否则是失败。

用户响应JSON格式如下所示:

{
  "code": 200,
  "data": {
    "code": 200,
    "message": "success."
  },
  "message": "操作成功"
}

4、发送短信验证码到手机

发送短信验证码到手机（method=web.passport.sendcode）

请求参数

参数名称 参数类型 可否为空 示例 默认值 备注
mobile string 否 13912345678 手机号码
area string 否 86 国家码

注意，通用的头部没有列出。
请求示例
http://127.0.0.1:8080/gateway?method=web.passport.sendcode&area=86&mobile=13912345678

响应

code为200即为成功，否则是失败。

用户响应JSON格式如下所示:

{
  "code": 200,
  "data": [],
  "message": "发送成功"
}

5、验证短信验证码是否正确

验证短信验证码是否正确（method=web.passport.checkcode）

请求参数

参数名称 参数类型 可否为空 示例 默认值 备注
mobile string 否 13912345678 手机号码
area string 否 86 国家码
code string 否 短信验证码

注意，通用的头部没有列出。
请求示例
http://127.0.0.1:8080/gateway?method=web.passport.checkcode&area=86&mobile=13912345678&code=9691

响应

code为200即为成功，否则是失败。

用户响应JSON格式如下所示:

{
  "code": 200,
  "data": [],
  "message": "校验成功"
}

6、修改验证手机前的检查

修改验证的手机前的检查（method=web.passport.checkVerifyMobile）

请求参数

参数名称 参数类型 可否为空 示例 默认值 备注
mobile string 否 13912345678 手机号码
area string 否 86 国家码

注意，通用的头部没有列出。
请求示例
http://127.0.0.1:8080/gateway?method=web.passport.checkVerifyMobile&area=86&mobile=13912345678

响应

code为200即为成功，否则是失败。

用户响应JSON格式如下所示:

{
  "code": 200,
  "data": [],
  "message": "操作成功"
}

7、修改验证的手机

修改验证的手机（method=web.passport.changeVerifyMobile）
调用该方法前，必须先要调用web.passport.checkVerifyMobile该接口做检查

请求参数

参数名称 参数类型 可否为空 示例 默认值 备注
newMobile string 否 13912345678 新的手机号码
area string 否 86 国家码
uid string 否 用户id

注意，通用的头部没有列出。
请求示例
http://127.0.0.1:8080/gateway?method=web.passport.changeVerifyMobile&uid=8041015&newMobile=13912345678&area=86

响应

code为200即为成功，否则是失败。

用户响应JSON格式如下所示:

{
  "code": 200,
  "data": {
    "code": 200,
    "message": "success."
  },
  "message": "操作成功"
}

7、验证邮箱，发送邮件

验证邮箱，发送邮件（method=web.passport.verifyEmail）

请求参数

参数名称 参数类型 可否为空 示例 默认值 备注
email string 否 t@163.com 用户邮箱
uid string 否 用户id

注意，通用的头部没有列出。
请求示例
http://127.0.0.1:8080/gateway?method=web.passport.verifyEmail&email=t@163.com&uid=12345

响应

code为200即为成功，否则是失败。

用户响应JSON格式如下所示:

{
  "code": 200,
  "data": [],
  "message": "操作成功"
}

8、找回密码，判断code是否有效

找回密码，判断code是否有效（method=web.passport.checkCodeValid）

请求参数

参数名称 参数类型 可否为空 示例 默认值 备注
code string 否 abcdef 加密的字符串

注意，通用的头部没有列出。
请求示例
http://127.0.0.1:8081/gateway?method=web.passport.checkCodeValid&code=abcdef

响应

code为200即为成功，否则是失败。

用户响应JSON格式如下所示:

{
  "code": 200,
  "data": [],
  "message": "操作成功"
}

10、修改验证的邮箱

修改验证的邮箱（method=web.passport.changeEmail）

请求参数

参数名称 参数类型 可否为空 示例 默认值 备注
code string 否 abcdef 加密的字符串

注意，通用的头部没有列出。
请求示例
http://127.0.0.1:8081/gateway?method=web.passport.changeEmail&code=abcdef

响应

code为200即为成功，否则是失败。

用户响应JSON格式如下所示:

{
  "code": 200,
  "data": [],
  "message": "操作成功"
}

11、获取个人信息

获取文章作者信息（?method=open.passport.get）

请求参数

参数名称 参数类型 可否为空 示例 默认值 备注
uid int 否 5357305 0 用户id

注意，通用的头部没有列出。
请求示例
http://192.168.102.205:8080/gateway/?method=open.passport.get&uid=5357305&debug=XYZ

响应

code为200即为成功，否则是失败。

响应JSON格式如下所示:（是按PHP代码返回的）

{
  "code": 200,
  "data": {
    "data": {
      "YohocoinCount": 0,//有货币数量
      "couponCount": 0,//优惠券数量
      "head_ico": "",//头像
      "messageCount": 0,//未读消息数
      "orderCount": 10,//待处理订单数
      "profile_name": "18****59670",//名称
      "random": 1458378392.046,//以前接口返回的，不知道啥用
      "refundCount": 0,//退换货数量
      "token": "",//以前的字段，现在没有
      "uid": 5357305,//用户id
      "vip": { //用户vip信息
        "curTotalCost": "0.0",//总消费
        "curVipInfo": { //当前vip信息
          "commonDiscount": "1.0", //普通折扣
          "curLevel": "0", //当前等级
          "needCost": "0.0",//需要花费多少
          "nextLevel": "1",//下一等级
          "premiumScops": [],//VIP权限
          "promotionDiscount": "1.0",//促销折扣
          "title": "普通会员"//VIP名称
        },
        "curYearCost": "0.0", //当年消费多少
        "curYearCostPer": "0",//目前消费百分比
        "fitTime": "1451053087",//以前的逻辑，是vipStartTime-15天
        "nextVipInfo": {//下一等级VIP信息
          "commonDiscount": "0.95",
          "curLevel": "1",
          "needCost": "600.0",
          "nextLevel": "2",
          "premiumScops": ["1","4","10","8","9"],
          "promotionDiscount": "0.95",
          "title": "银卡会员"
        },
        "upgradeNeedCost": "600.0",//升级需要花费多少
        "upgradeNeedCostPer": "100",//升级需要的百分比
        "vipEndDay": "295",//VIP剩余多少天
        "vipEndTime": "1483885087",//VIP结束时间
        "vipRemainDays": "295",//VIP剩余多少天
        "vipStartTime": "1452349087"//VIP开始时间
      }
    },
    "result": "1"
  },
  "message": "User info"
}