# 管理类接口



# 新页面

# 登录

#### **接口用途**

- 用户名密码验证，下发token

#### **接口地址**

- [https://qrpaymobiletest.e-buychina.com.cn/web/api/loginCheck](https://qrpaymobiletest.e-buychina.com.cn/web/api/loginCheck)

#### **请求参数**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>app流水号</td><td>不允许重复</td></tr><tr><td>loginName</td><td>String</td><td>是</td><td>用户名</td><td> </td></tr><tr><td>loginPsw</td><td>String</td><td>是</td><td>密码</td><td>需加密上传：MD5(loginName + MD5(psw))</td></tr></tbody></table>

#### **请求报文举例**

```
{
    "traceNo": "APPTEST9100010101732123010",
    "loginName": "111",
    "loginPsw":"C529D04DD76D856FE3A8A871B476DC4D"
}

```

#### **返回参数**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-r"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00表示交易成功，其他表示失败</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>交易结果描述或错误原因</td></tr><tr><td>tokenId</td><td>String</td><td>是</td><td>token</td><td> </td></tr><tr><td>merchantAddr</td><td>String</td><td>是</td><td>商户地址</td><td> </td></tr><tr><td>merchantName</td><td>String</td><td>是</td><td>商户名称</td><td> </td></tr><tr><td>brandName</td><td>String</td><td>是</td><td>品牌名称</td><td> </td></tr><tr><td>brandLogo</td><td>String</td><td>是</td><td>品牌logo</td><td> </td></tr><tr><td>operator</td><td>[Operator](https://book.e-buy.com/books/ebuy-epointvoucher/page/8d5e9)</td><td>是</td><td>用户信息</td></tr></tbody></table>

#### **返回报文举例**

```
{
    "returnCode": "00",
    "tokenId": "5f2f330464bd4d2ab9cd57604fbffb99",
    "merchantAddr": "東京都中央区銀座8-8-11",
    "merchantName": "博品館TOY PARK",
    "returnDesc": "登录成功",
    "brandName": "博品館",
    "operator": {
        "operatorId": 38,
        "alias": "22222",
        "nickName": "hakuhinkan001403",
        "status": 1,
        "role": 3,
        "func": "0001120",
        "merchantId": 323427,
        "tid": "94392307",
        "currency": "JPY",
        "loginName": "hakuhinkan001403"
    },
    "brandLogo": "https://jperp3.e-buychina.com/upload/20190819153240_merchant_c1562959.png"
}
```

# 刷新Token

#### **接口用途**

- 更新token

#### **接口地址**

- [https://qrpaymobiletest.e-buychina.com.cn/web/api/refreshToken](https://qrpaymobiletest.e-buychina.com.cn/web/api/refreshToken)

#### **请求参数**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>app流水号</td><td>不允许重复</td></tr></tbody></table>

#### **请求报文举例**

```
{
    "traceNo": "APPTEST9100010101732123010"
}

```

#### **返回参数**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-r"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00表示交易成功，其他表示失败</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>交易结果描述或错误原因</td></tr><tr><td>tokenId</td><td>String</td><td>是</td><td>token</td></tr></tbody></table>

#### **返回报文举例**

```
{
    "returnCode": "00",
    "tokenId": "1118207c6d424de3a7bcc128aa728018",
    "returnDesc": "更新成功"
}

```

<footer class="page-footer" id="bkmrk-"></footer>

# 个人主页信息

#### **接口用途**

- 获取个人信息，显示主页

#### **接口地址**

- [https://qrpaymobiletest.e-buychina.com.cn/web/api/showOperator](https://qrpaymobiletest.e-buychina.com.cn/web/api/showOperator)

#### **请求参数**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>app流水号</td><td>不允许重复</td></tr></tbody></table>

#### **请求报文举例**

```
{
    "traceNo": "APPTEST9100010101732123010"
}

```

#### **返回参数**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-r"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00表示交易成功，其他表示失败</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>交易结果描述或错误原因</td></tr><tr><td>operator</td><td>[Operator](https://book.e-buy.com/books/ebuy-epointvoucher/page/8d5e9)</td><td>是</td><td>用户信息</td><td> </td></tr><tr><td>operatorChild</td><td>List&lt;[Operator](https://book.e-buy.com/books/ebuy-epointvoucher/page/8d5e9)&gt;</td><td>否</td><td>店员列表</td><td>主账号为店长时下发</td></tr></tbody></table>

#### **返回报文举例**

```
{
    "returnCode": "00",
    "operatorChild": [{
        "role": 3,
        "nickName": "yangxm",
        "loginName": "yangxm",
        "remark": "杨",
        "operatorId": 34,
        "status": 1
    }, {
        "role": 3,
        "nickName": "hello",
        "loginName": "hello",
        "remark": "qqq",
        "operatorId": 33,
        "status": 0
    }],
    "returnDesc": "处理成功",
    "operator": {
        "role": 4,
        "merchantId": 2430,
        "nickName": "111",
        "loginName": "111",
        "alias": "69AE3117EC013818",
        "currency": "CNY",
        "operatorId": 27,
        "tid": "99001061",
        "status": 1
    }
}
```

# 新增/修改店员信息

#### **接口用途**

- 店员可修改自己帐号信息，店长可修改自己帐号信息及店员的部分信息

#### **接口地址**

- [https://qrpaymobiletest.e-buychina.com.cn/web/api/addOperator](https://qrpaymobiletest.e-buychina.com.cn/web/api/addOperator)

#### **请求参数**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>app流水号</td><td>不允许重复</td></tr><tr><td>operator</td><td>[Operator](https://book.e-buy.com/books/ebuy-epointvoucher/page/8d5e9)</td><td>是</td><td>用户信息</td><td>新增：上送全部字段；修改：只上送id及需要修改的字段</td></tr></tbody></table>

#### **请求报文举例**

```
{
  "traceNo" : "MW1560133047843001211",
  "operator" : {
    "status" : 1,
    "remark" : "222",
    "loginName" : "111",
    "role" : 3,
    "loginPsw" : "C529D04DD76D856FE3A8A871B476DC4D",
    "nickName" : "111",
    "operatorId" : 27
  }
}

```

#### **返回参数**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-r"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00表示交易成功，其他表示失败</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>交易结果描述或错误原因</td></tr></tbody></table>

#### **返回报文举例**

```
{
    "returnCode": "00",
    "returnDesc": "处理成功"
}
```