[关闭]
@yaohang 2018-06-01T02:36:07.000000Z 字数 3509 阅读 930

接口下发文档

用户注册

* URI /OpenAPI/V1/ThirdPartyAuth/userCreate

* 请求参数

参数名 类型 描述 是否为空 默认值
merchant_key string 商户app_key 否 无
version string 接口版本号 否 无
data string 加密字符串 否 无

data参数详情:

参数名 类型 描述 是否为空 默认值
data[username] string 用户名 否 无
data[nickname] string 用户昵称 否 无
data[avatar] string 头像地址 是 默认图

请求成功返回结果:

  1. {
  3.     "code": 0,
  5.     "msg": "ok",
  7.     "data": {
  9.         "username": "woxijiajiahui03",
  11.         "merchant_token": "b5d460d7fa9059f15df69d62ecfb5faf"
  13.     }
  15. }

请求失败返回结果:

  1. {
  3.     "code": 1,
  5.     "msg": “商户号错误",
  7.     "data": null
  9. }

备注：

  1. 接口中，username需要是接入商户平台中用户的唯一值，不能重复。后面接口中涉及username不再赘述。
  2. Data 数组应该用AES加密之后再传递 。后面接口中涉及data参数不再赘述，加密方式见文末。

​

用户登录

* URI /OpenAPI/V1/ThirdPartyAuth/userLogin

* 请求参数

参数名 类型 描述 是否为空 默认值
merchant_key string 商户app_key 否 无
version string 接口版本号 否 无
data string 加密字符串 否 无

data参数详情:

参数名 类型 描述 是否为空 默认值
data[username] string 用户名 否 无

请求成功返回结果 json

  1. {
  3.     "code": 0,
  5.     "msg": "ok",
  7.     "data": {
  9.         "loginurl": "6MuW5F+gWPViA3e2ImiXIvgjHlJxahwmZYkcYHFxoCM="
  11.     }
  13. }

请求失败返回结果 json

  1. {
  3.     "code": 1,
  5.     "msg": "商户号错误",
  7.     "data": null
  9. }

备注：返回参数 loginurl 需要按照文末解密方式解密

划账接口 （入账）

* URI /OpenAPI/V1/ThirdPartyAuth/userDeposit

* 请求参数

参数名 类型 描述 是否为空 默认值
merchant_key string 商户app_key 否 无
version string 接口版本号 否 无
data string 加密字符串 否 无

data参数详情:

参数名 类型 描述 是否为空 默认值
data[username] string 用户名 否 无
data[amount] int 金额 否 无
data[extTransId] string 唯一识别订单号 否 无

请求成功返回结果 json

  1. {
  3.     "code": 0,
  5.     "msg": "ok",
  7.     "data": {
  9.         "user_money": 1,
  11.         "detail": "505094",
  13.         "coin": "3.00",
  15.         "coin_before": "100025.00",
  17.         "coin_after": "100028.00"
  19.     }
  21. }

请求失败返回结果 json

  1. {
  3.     "code": 1,
  5.     "msg": "错误",
  7.     "data": null
  9. }

划账接口 （出账）

*** URI /OpenAPI/V1/ThirdPartyAuth/userWithdraw **

* 请求参数

参数名 类型 描述 是否为空 默认值
merchant_key string 商户app_key 否 无
version string 接口版本号 否 无
data string 加密字符串 否 无

data参数详情:

参数名 类型 描述 是否为空 默认值
data[username] string 用户名 否 无
data[amount] int 金额 否 无
data[extTransId] string 唯一识别订单号 否 无

请求成功返回结果 json

  1. {
  3.     "code": 0,
  5.     "msg": "ok",
  7.     "data": {
  9.         "user_money": 1,
  11.         "detail": "505094",
  13.         "coin": "3.00",
  15.         "coin_before": "100025.00",
  17.         "coin_after": "100028.00"
  19.     }
  21. }

请求失败返回结果 json

  1. {
  3.     "code": 1,
  5.     "msg": "错误",
  7.     "data": null
  9. }

查询用户信息

* URI /OpenAPI/V1/ThirdPartyAuth/userProfile

* 请求参数

参数名 类型 描述 是否为空 默认值
merchant_key string 商户app_key 否 无
version string 接口版本号 否 无
data string 加密字符串 否 无

data参数详情:

参数名 类型 描述 是否为空 默认值
data[username] string 用户名 否 无

请求成功返回结果 json

  1. {
  3.     "code": 0,
  5.     "msg": "ok",
  7.     "data": {
  9.         "id": "12039",
  11.         "avatar": "http://api.vzboo.net/style/avatar/00b/12039_middle.jpg?t=1527499800",
  13.         "nickname": "woxijiajiahui03_6658",
  15.         "username": "woxijiajiahui03",
  17.         "rctoken": "4rRj+s/caMl4fxoiMAQh6ofadmfeXW==",
  19.         "sex": "1",
  21.         "curroomnum": "1579341516",
  23.         "avatartime": "1527499800",
  25.         "city": "保密",
  27.         "birthday": "959851800",
  29.         "wxunionid": null,
  31.         "approveid": "无",
  33.         "isaudit": "y",
  35.         "province": "保密",
  37.         "intro": "暂时还没有想说的～",
  39.         "professional": "",
  41.         "emotion": "0"
  43.     }
  45. }

请求失败返回结果 json

  1. {
  3.     "code": 1,
  5.     "msg": "错误",
  7.     "data": null
  9. }

获取用户消费信息

* URI /OpenAPI/V1/ThirdPartyAuth/getRecords

* 请求参数

参数名 类型 描述 是否为空 默认值
merchant_key string 商户app_key 否 无
version string 接口版本号 否 无
data[ string 加密字符串 否 无

data参数详情:

参数名 类型 描述 是否为空 默认值
data[username] string 用户名 否 无
data[page] int 页数 是 1
data[size] int 每页数量 是 20
data[type] string 查询类型 是 null
data[day] string 2018-06-01 是 当日

请求成功返回结果 json

  1. {
  3.     "code": 0,
  5.     "msg": "ok",
  7.     "data": {
  9.         "balance": {
  11.             "title": "余额",
  13.             "coin": "+100000.00",
  15.             "unit": "金币"
  17.         },
  19.         "all": {
  21.             "menu": [
  23.                 {
  25.                     "title": "游戏总收益",
  27.                     "coin": "+0",
  29.                     "unit": "金币"
  31.                 },
  33.                 {
  35.                     "title": "礼物总消费",
  37.                     "coin": "-0.0000",
  39.                     "unit": "金币"
  41.                 }
  43.             ],
  45.             "data": [
  47.                 {
  49.                     "id": "504947",
  51.                     "title": "后台加钱",
  53.                     "content": "后台加钱",
  55.                     "coin": "+100000.0000",
  57.                     "unit": "金币",
  59.                     "date": "2018-05-29 11:51:54"
  61.                 }
  63.             ]
  65.         },
  67.         "live": {
  69.             "menu": [
  71.                 {
  73.                     "title": "礼物总消费",
  75.                     "coin": "-0.0000",
  77.                     "unit": "金币"
  79.                 }
  81.             ],
  83.             "data": [
  85.                 {
  87.                     "id": "504947",
  89.                     "title": "后台加钱",
  91.                     "content": "后台加钱",
  93.                     "coin": "+100000.0000",
  95.                     "unit": "金币",
  97.                     "date": "2018-05-29 11:51:54"
  99.                 }
  101.             ]
  103.         },
  105.         "game": {
  107.             "menu": [
  109.                 {
  111.                     "title": "游戏总收益",
  113.                     "coin": "+0",
  115.                     "unit": "金币"
  117.                 }
  119.             ],
  121.             "data": []
  123.         }
  125.     }
  127. }

请求失败返回结果 json

  1. {
  3.     "code": 1,
  5.     "msg": "错误",
  7.     "data": null
  9. }

备注 ：

data[type] 传值为空的话默认能够查询到直播和游戏的消费记录 当为 game 时查询游戏消费记录live时查询直播消费记录

加密说明

以上接口中 data 数组全部以 按照键名对关联数组进行升序排序之后转换为json字符串。然后对字符串进行 AES/ECB/PKCS7Padding 加密 （加密密码为商户密钥）

解密说明

返回的加密字符串用 AES/ECB/PKCS7Padding 解谜 （加密密码为商户密钥）

加解密校验网站 http://tool.chacuo.net/cryptaes

添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注