[关闭]
@yaohang 2018-06-01T08:50:10.000000Z 字数 4570 阅读 808

商户平台下发接口文档

1.创建新玩家账号

请求URL

/OpenAPI/V1/ThirdPartyAuth/userCreate

接口说明

新玩家从商户网站或者APP SDK接入用户进入LV网站时，需要调用此接口创建用户

请求方式

POST

请求参数

请求参数 类型 可否为空 参数说明
merchant_key string N 商户APP KEY
version string Y 版本号，可为空，若 不填则默认为 1.0.0
data string N AES加密data原始内容，再使用Base64编码

基本参数示例

请求参数 示例
merchant_key sfEqhGQgALSaslK
version 1.0
data mJFvlnXbz2mrefVmdbtGRbaX2x91c2/wdPVlz52vNiA=

加密参数data内容

参数 类型 可否为空 参数说明
username string Y 用户名 （商户平台 用户的唯一值）
nickname string Y 用户昵称
avatar string N 用户头像，为空则使用默认头像

加密内容参数示例，JSON 格式

  1. {
  2.     "avatar": "http:\/\/imgsrc.baidu.com\/forum\/w=580\/sign=1588b7c5d739b6004dce0fbfd9503526\/7bec54e736d12f2eb97e1a464dc2d56285356898.jpg",
  3.     "nickname": "测试者",
  4.     "username": "tester"
  5. }

注:此参数需要转换为 json 格式后进行加密(加密方式参考加密说明)

接口返回

返回参数 参数类型 参数说明
code integer 0 为执行成功 1 为执行失败
msg sting 报错内容
data string 接口返回内容 (需解密参考加密说明)

接口返回示例

  1. {
  2.     "code": 0,
  3.     "msg": "ok",
  4.     "data":"6MuW5F+gWPViA3e2ImiXIvgjHlJxahwmZYkcYHFxoCM=",  
  5. }
返回参数 参数类型 参数说明
merchant_token string SDK接入商户，用户登录需使用到此参数. WEB接入商户用户可忽略此参数。

2.玩家登录

请求URL

/OpenAPI/V1/ThirdPartyAuth/userLogin

接口说明

玩家从商户网站登录LV游戏时调用此接口，获取登录地址，通过该地址访问LV网站

请求方式

POST

请求参数

请求参数 类型 可否为空 参数说明
merchant_key string N 商户APP KEY
version string Y 版本号，可为空，若 不填则默认为 1.0.0
data string N AES加密data原始内容，再使用Base64编码

基本参数示例

请求参数 示例
merchant_key sfEqhGQgALSaslK
version 1.0
data mJFvlnXbz2mrefVmdbtGRbaX2x91c2/wdPVlz52vNiA=

加密参数data内容

参数 类型 可否为空 参数说明
username string N 用户名 （商户平台 用户的唯一值）
login_time string N 玩家登录时间，使用 GMT-8 时区，格式 为:yyyy-MM-dd HH:mm:ss,若登录时 间与当前时间相差超过 24 小时，则拒绝 此次登录请求
terminal string Y 终端类型，为空或者”pc”表示电脑 端，”mobile”表示 手机端

加密内容参数示例，JSON 格式

  1. {
  2.     "terminal": "PC",
  3.     "login_time": "2016-10-10 13:20:59",
  4.     "username": "tester"
  5. }

注:此参数需要转换为 json 格式后进行加密(加密方式参考加密说明)

返回参数 参数类型 参数说明
code integer 0 为执行成功 1 为执行失败
msg sting 报错内容
data string 接口返回内容

接口返回示例

  1. {
  2.     "code": 0,
  3.     "msg": "ok",
  4.     "data":"6MuW5F+gWPViA3e2ImiXIvgjHlJxahwmZYkcYHFxoCM=",  
  5. }
返回参数 参数类型 参数说明
loginurl string 被加密的WEB跳转url，通过此url 可访问WEB游戏

3.资金转入

请求URL

/OpenAPI/V1/ThirdPartyAuth/userDeposit

接口说明

商户用户转入资金时，调用此接口。用户转入成功后，将从商户余额中扣 减对应资金，若商户余额不足，则转入不成功。

请求方式

POST

请求参数

请求参数 类型 可否为空 参数说明
merchant_key string N 商户APP KEY
version string Y 版本号，可为空，若 不填则默认为 1.0.0
data string N AES加密data原始内容，再使用Base64编码

基本参数示例

请求参数 示例
merchant_key sfEqhGQgALSaslK
version 1.0
data mJFvlnXbz2mrefVmdbtGRbaX2x91c2/wdPVlz52vNiA=

加密参数data内容

参数 类型 可否为空 参数说明
username string N 用户名 （商户平台 用户的唯一值）
amount integer N 转入金额
extTransId string N 商户唯一识别订单号

加密内容参数示例，JSON 格式

  1. {
  2.     "username": "tester",
  3.     "amount": "1000",
  4.     "extTransId": "10086452134215"
  5. }

注:此参数需要转换为 json 格式后进行加密(加密方式参考加密说明)

返回参数 参数类型 参数说明
code integer 0 为执行成功 1 为执行失败
msg sting 报错内容
data string 接口返回内容

接口返回示例

  1. {
  2.     "code": 0,
  3.     "msg": "ok",
  4.     "data":"6MuW5F+gWPViA3e2ImiXIvgjHlJxahwmZYkcYHFxoCM=",  
  5. }
返回参数 参数类型 参数说明
balance float 用户当前余额

4.资金转出

请求URL

/OpenAPI/V1/ThirdPartyAuth/userWithdraw

接口说明

商户用户从LV平台转出资金时，调用此接口。用户转出成功后，商户余额会增加对 应资金。

请求方式

POST

请求参数

请求参数 类型 可否为空 参数说明
merchant_key string N 商户APP KEY
version string Y 版本号，可为空，若 不填则默认为 1.0.0
data string N AES加密data原始内容，再使用Base64编码

基本参数示例

请求参数 示例
merchant_key sfEqhGQgALSaslK
version 1.0
data mJFvlnXbz2mrefVmdbtGRbaX2x91c2/wdPVlz52vNiA=

加密参数data内容

参数 类型 可否为空 参数说明
username string N 用户名 （商户平台 用户的唯一值）
amount integer N 转入金额
extTransId string N 商户唯一识别订单号

加密内容参数示例，JSON 格式

  1. {
  2.     "username": "tester",
  3.     "amount": "1000",
  4.     "extTransId": "10086452134215"
  5. }

注:此参数需要转换为 json 格式后进行加密(加密方式参考加密说明)

返回参数 参数类型 参数说明
code integer 0 为执行成功 1 为执行失败
msg sting 报错内容
data string 接口返回内容

接口返回示例

  1. {
  2.     "code": 0,
  3.     "msg": "ok",
  4.     "data":"6MuW5F+gWPViA3e2ImiXIvgjHlJxahwmZYkcYHFxoCM=",  
  5. }
返回参数 参数类型 参数说明
balance float 用户当前余额

5.用户信息查询（包含余额查询）

请求URL

/OpenAPI/V1/ThirdPartyAuth/userProfile

接口说明

当商户玩家需要查询用户在LV平台里的用户信息时，调用此接口。

请求方式

POST

请求参数

请求参数 类型 可否为空 参数说明
merchant_key string N 商户APP KEY
version string Y 版本号，可为空，若 不填则默认为 1.0.0
data string N AES加密data原始内容，再使用Base64编码

基本参数示例

请求参数 示例
merchant_key sfEqhGQgALSaslK
version 1.0
data mJFvlnXbz2mrefVmdbtGRbaX2x91c2/wdPVlz52vNiA=

加密参数data内容

参数 类型 可否为空 参数说明
username string N 用户名 （商户平台 用户的唯一值）

加密内容参数示例，JSON 格式

  1. {
  2.     "username": "tester",
  3. }

注:此参数需要转换为 json 格式后进行加密(加密方式参考加密说明)

返回参数 参数类型 参数说明
code integer 0 为执行成功 1 为执行失败
msg sting 报错内容
data string 接口返回内容

接口返回示例

  1. {
  2.     "code": 0,
  3.     "msg": "ok",
  4.     "data":"6MuW5F+gWPViA3e2ImiXIvgjHlJxahwmZYkcYHFxoCM=",  
  5. }
返回参数 参数类型 参数说明
avatar string 用户头像地址
nickname string 用户昵称
username string 用户名
balance float 用户当前余额
merchant_token string 用户的商户token(sdk接入使用)

6.获取用户消费记录

请求URL

/OpenAPI/V1/ThirdPartyAuth/getRecords

接口说明

当商户玩家需要查询在LV平台里的消费记录时，调用此接口。

请求方式

POST

请求参数

请求参数 类型 可否为空 参数说明
merchant_key string N 商户APP KEY
version string Y 版本号，可为空，若 不填则默认为 1.0.0
data string N AES加密data原始内容，再使用Base64编码

基本参数示例

请求参数 示例
merchant_key sfEqhGQgALSaslK
version 1.0
data mJFvlnXbz2mrefVmdbtGRbaX2x91c2/wdPVlz52vNiA=

加密参数data内容

参数 类型 可否为空 参数说明
username string N 用户名 （商户平台 用户的唯一值）
page integer N 页数
size integer N 每页数量
type string N GAME 游戏记录 LIVE 打赏记录
day string N 2018-06-01

加密内容参数示例，JSON 格式

  1. {
  2.     "username": "tester",
  3.     "page": "1",
  4.     "size": "30",
  5.     "type": "LIVE",
  6.     "day": "2018-06-01",
  7. }

注:此参数需要转换为 json 格式后进行加密(加密方式参考加密说明)

返回参数 参数类型 参数说明
code integer 0 为执行成功 1 为执行失败
msg sting 报错内容
data string 接口返回内容

加密说明

>
LV 商户平台下发接口 全部采用 AES-128, algorithm/mode/padding 为 AES/ECB/PKCS5Padding。

加密调试参考网站： http://tool.chacuo.net/cryptaes

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