# 用户信息接口

## 用户注册接口

<mark style="color:green;">`POST`</mark> `https://service.xxx.com/platformapi/chainup/open/user/registration`

需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign

#### Headers

| Name         | Type   | Description      |
| ------------ | ------ | ---------------- |
| Content-Type | String | application/json |

#### Request Body

| Name                                      | Type   | Description                  |
| ----------------------------------------- | ------ | ---------------------------- |
| app\_id<mark style="color:red;">\*</mark> | String | 商家唯一编号                       |
| time<mark style="color:red;">\*</mark>    | String | 请求时间                         |
| sign<mark style="color:red;">\*</mark>    | String | 用rsa\_third\_pri对query中的数据签名 |
| data<mark style="color:red;">\*</mark>    | String | rsa\_saas\_pub加密query中数据     |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息	
    "data": "",
    "sign": ""
}

data 中解密后的结构体
{
    "uid": 2000000,//用户id
    "inviteCode": "AAAAAA"//邀请码   
}
```

{% endtab %}
{% endtabs %}

以下为参与rsa加密的参数:

手机号和邮箱填写,只能填写其中一个

<table><thead><tr><th width="136">名称</th><th width="124">类型</th><th>是否必需</th><th width="214">例子</th><th>描述</th></tr></thead><tbody><tr><td>mobileNumber</td><td>String</td><td>NO</td><td>09011223</td><td>手机号码</td></tr><tr><td>email</td><td>String</td><td>NO</td><td>xxxxx@.com</td><td>用户邮箱</td></tr><tr><td>countryCode</td><td>String</td><td>NO</td><td>93</td><td>手机号的国家拨号码<br></td></tr><tr><td>password</td><td>String</td><td>YES</td><td>TtEest19121</td><td>密码</td></tr><tr><td>invitedCode</td><td>String</td><td>YES</td><td>QSKNOQQQ</td><td>邀请码</td></tr></tbody></table>

## 用户注册信息

<mark style="color:green;">`POST`</mark> `https://service.xxx.com/platformapi/chainup/open/user/reg_info_list`

需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign

#### Headers

| Name         | Type   | Description      |
| ------------ | ------ | ---------------- |
| Content-Type | String | application/json |

#### Request Body

| Name                                      | Type   | Description                  |
| ----------------------------------------- | ------ | ---------------------------- |
| app\_id<mark style="color:red;">\*</mark> | String | 商家唯一编号                       |
| sign<mark style="color:red;">\*</mark>    | String | 用rsa\_third\_pri对query中的数据签名 |
| data<mark style="color:red;">\*</mark>    | String | rsa\_saas\_pub加密query中数据     |
| time<mark style="color:red;">\*</mark>    | String | 请求时间                         |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息	
    "data": "",
    "sign": ""
}

data 中解密后的结构体


{
    "userInfoList": [
      {
        "uid": 23000,//用户uid
        "mobileNumber": "9989921",
        "email": "www@.com",
        "inviteCode": "SDONOQWE",//邀请码
        "pid": "3999009"//父级uid
      }
    ],
    "count": 20
  }
```

{% endtab %}
{% endtabs %}

以下为参与rsa加密的参数:

<table><thead><tr><th width="136">名称</th><th width="124">类型</th><th>是否必需</th><th width="214">例子</th><th>描述</th></tr></thead><tbody><tr><td>page</td><td>String</td><td>NO</td><td>1</td><td>翻页页数,不填默认为1</td></tr><tr><td>pageSize</td><td>String</td><td>NO</td><td>20</td><td>每页数量,不填默认为100</td></tr><tr><td>regStartTime</td><td>String</td><td>YES</td><td>1232123421123</td><td>开始注册时间(13位时间戳)</td></tr></tbody></table>

## 邀请关系查询-上级

## 返回当前查询到的所有上级,最高五级

<mark style="color:green;">`POST`</mark> `https://service.xxx.com/platformapi/chainup/open/user/user_superior`

需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign

#### Headers

| Name         | Type   | Description      |
| ------------ | ------ | ---------------- |
| Content-Type | String | application/json |

#### Request Body

| Name                                     | Type   | Description                  |
| ---------------------------------------- | ------ | ---------------------------- |
| appKey<mark style="color:red;">\*</mark> | String | 商家唯一app\_id                  |
| sign<mark style="color:red;">\*</mark>   | String | 用rsa\_third\_pri对query中的数据签名 |
| time<mark style="color:red;">\*</mark>   | String | 请求时间                         |
| data<mark style="color:red;">\*</mark>   | String | rsa\_saas\_pub加密query中数据     |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息	
    "data": "",
    "sign": ""
}

data 中解密后的结构体
{
    "user": {
      "uid": 230001,//用户id  
      "inviteCode": "WEQSDA",//邀请码  
      "invitedCode": "OONSIAD",//被邀请码  
      "invitedUid": 2300002 //邀请人Uid  
    },
    "level1": {
      "uid": 230003,//用户id 
      "inviteCode": "SDKKCNASD",//邀请码  
      "invitedCode": "SDOMMQWE",//被邀请码  
      "invitedUid": 2399901//邀请人Uid 
    },
    "level2": {
      "uid": 230003,//用户id 
      "inviteCode": "SDKKCNASD",//邀请码  
      "invitedCode": "SDOMMQWE",//被邀请码  
      "invitedUid": 2399901//邀请人Uid 
    }
  }

```

{% endtab %}
{% endtabs %}

以下为参与rsa加密的参数:

openid,用户uid,与openId和emailOrPhone三选一,优先uid

<table><thead><tr><th width="136">名称</th><th width="124">类型</th><th>是否必需</th><th width="214">例子</th><th>描述</th></tr></thead><tbody><tr><td>openId</td><td>String</td><td>NO</td><td></td><td>该授权用户所属该商户下的唯一openId</td></tr><tr><td>uid</td><td>String</td><td>NO</td><td></td><td>用户id</td></tr><tr><td>emailOrPhone</td><td>String</td><td>NO</td><td></td><td>手机号或者邮箱号</td></tr></tbody></table>

## 邀请关系查询-下级

<mark style="color:green;">`POST`</mark> `https://service.xxx.com/platformapi/chainup/open/user/user_invite`

需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign

#### Headers

| Name         | Type   | Description      |
| ------------ | ------ | ---------------- |
| Content-Type | String | application/json |

#### Request Body

| Name                                      | Type   | Description                  |
| ----------------------------------------- | ------ | ---------------------------- |
| app\_id<mark style="color:red;">\*</mark> | String | 商家唯一编号                       |
| sign<mark style="color:red;">\*</mark>    | String | 用rsa\_third\_pri对query中的数据签名 |
| data<mark style="color:red;">\*</mark>    | String | rsa\_saas\_pub加密query中数据     |
| time<mark style="color:red;">\*</mark>    | String | 请求时间                         |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息	
    "data": "",
    "sign": ""
}

data 中解密后的结构体


{
    "levelOneCount": 4,//第一层子级
    "levelTwoCount": 9,//第二层子级
    "cuerrentUser": {
      "uid": 10002053,//当前用户uid
      "nickname": "xuyang",//当前用户nickname
      "inviteCode": "EAAAQATW",//当前用户邀请码
      "invitedUid": -1,//当前用户邀请人,不存在时返回-1
      "invitedCode": "",//当前用户被邀请码,不存在返回空串
      "ctime": "2019-09-02 12:24:36"
    },
    "userExtInviteVoList": [//被邀请人列表
      {
        "uid": 10002183,//uid
        "nickname": "小明",//nickname
        "inviteCode": "XXXXXXXX",//邀请码
        "level": 1,//第一层子级
        "invitedUid": 10002181,//邀请人uid
        "invitedNickname": "小花",//邀请人nickname
        "invitedCode": "XXXXXXXX",//邀请人邀请码
        "phone": "18310479052",//手机号码
        "email": "111@163.com",//email
        "ctime": "2020-08-22 19:40:18",//注册时间
        "childLevel": [
          {
            "uid": 10002065,
            "nickname": "小明",
            "inviteCode": "XXXXXXXX",
            "level": 2,//第二层子级
            "invitedUid": 10002183,
            "invitedNickname": "小花",
            "invitedCode": "XXXXXXXX",
            "phone": "18210479051",
            "email": "111@163.com",
            "ctime": "2020-04-09 20:52:26"
          },
          {
            "uid": 10002065,
            "nickname": "小明",
            "inviteCode": "XXXXXXXX",
            "level": 2,
            "invitedUid": 10002183,
            "invitedNickname": "小花",
            "invitedCode": "XXXXXXXX",
            "phone": "18210479051",
            "email": "111@163.com",
            "ctime": "2020-04-09 20:52:26"
          },
          {
            "uid": 10002065,
            "nickname": "小明",
            "inviteCode": "XXXXXXXX",
            "level": 2,
            "invitedUid": 10002183,
            "invitedNickname": "小花",
            "invitedCode": "XXXXXXXX",
            "phone": "18210479051",
            "email": "111@163.com",
            "ctime": "2020-04-09 20:52:26"
          },
          {
            "uid": 10002065,
            "nickname": "小明",
            "inviteCode": "XXXXXXXX",
            "level": 2,
            "invitedUid": 10002183,
            "invitedNickname": "小花",
            "invitedCode": "XXXXXXXX",
            "phone": "18210479051",
            "email": "111@163.com",
            "ctime": "2020-04-09 20:52:26"
          },
          {
            "uid": 10002065,
            "nickname": "小明",
            "inviteCode": "XXXXXXXX",
            "level": 2,
            "invitedUid": 10002183,
            "invitedNickname": "小花",
            "invitedCode": "XXXXXXXX",
            "phone": "18210479051",
            "email": "111@163.com",
            "ctime": "2020-04-09 20:52:26"
          }
        ]
      }
    ]
  }
```

{% endtab %}
{% endtabs %}

以下为参与rsa加密的参数:

<table><thead><tr><th width="136">名称</th><th width="124">类型</th><th>是否必需</th><th width="214">例子</th><th>描述</th></tr></thead><tbody><tr><td>openId</td><td>String</td><td>NO</td><td></td><td>该授权用户所属该商户下的唯一openId</td></tr><tr><td>uid</td><td>String</td><td>NO</td><td></td><td>用户uid</td></tr><tr><td>emailOrPhone</td><td>String</td><td>NO</td><td></td><td>手机号或者邮箱号</td></tr><tr><td>page</td><td>String</td><td>YES</td><td>1</td><td>翻页页数,不填默认为1</td></tr><tr><td>pageSize</td><td>String</td><td>YES</td><td>20</td><td>每页数量,不填默认为100</td></tr></tbody></table>

## 用户实名接口

<mark style="color:green;">`POST`</mark> `https://service.xxx.com/platformapi/chainup/open/user/verifyUserIdentity`

需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign

#### Headers

| Name         | Type   | Description      |
| ------------ | ------ | ---------------- |
| Content-Type | String | application/json |

#### Request Body

| Name                                      | Type   | Description                  |
| ----------------------------------------- | ------ | ---------------------------- |
| app\_id<mark style="color:red;">\*</mark> | String | 商家唯一编号                       |
| sign<mark style="color:red;">\*</mark>    | String | 用rsa\_third\_pri对query中的数据签名 |
| data<mark style="color:red;">\*</mark>    | String | rsa\_saas\_pub加密query中数据     |
| time<mark style="color:red;">\*</mark>    | String | 请求时间                         |

{% tabs %}
{% tab title="200: OK " %}

```javascript

{
    "code": "0",
    "msg": "suc",
    "sign": "",
    "data": ""
}
```

{% endtab %}
{% endtabs %}

以下为参与rsa加密的参数:

<table><thead><tr><th width="136">名称</th><th width="124">类型</th><th>是否必需</th><th width="214">例子</th><th>描述</th></tr></thead><tbody><tr><td>uid</td><td>String</td><td>YES</td><td>230000</td><td>用户id</td></tr><tr><td>countryCode</td><td>String</td><td>YES</td><td>93</td><td>国家编码,需要输入正确的code,code在左侧国家编码中获取</td></tr><tr><td>certificateNumber</td><td>String</td><td>YES</td><td>211111111111</td><td>证件号码</td></tr><tr><td>familyName</td><td>String</td><td>YES</td><td>test</td><td>姓</td></tr><tr><td>name</td><td>String</td><td>YES</td><td>test</td><td>名</td></tr><tr><td>firstPhoto</td><td>String</td><td>NO</td><td></td><td>证件照片,只支持在线图片地址,最多输入三个,逗号分隔,例: "https://oss.com.https://oss.com,https://oss.com"</td></tr></tbody></table>

## 用户登录历史

<mark style="color:green;">`POST`</mark> `https://service.xxx.com/platformapi/chainup/open/user/getUserHistoryLogin`

#### Headers

| Name         | Type   | Description      |
| ------------ | ------ | ---------------- |
| Content-Type | String | application/json |

#### Request Body

| Name                                     | Type   | Description              |
| ---------------------------------------- | ------ | ------------------------ |
| appKey<mark style="color:red;">\*</mark> | String | 商家唯一编号appKey             |
| sign<mark style="color:red;">\*</mark>   | String |                          |
| uid<mark style="color:red;">\*</mark>    | String | 用户id                     |
| endDate                                  | String | 结束时间 2024-00-00 00:00:00 |
| startDate                                | String | 开始时间 2024-00-00 00:00:00 |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "code": "0",
    "msg": "suc",
    "data": {
        "count": 10,
        "HistoryLogin": [
            {
                "id": 2323332,
                "uid": 2324288,//用户id
                "lgType": 1,//登录方式，1：手机号，2：邮件，3：微信，4：QQ，5：APP扫码登录
                "lgPlatform": 3,//登录平台，1：WEB，2：H5，3：APP ,4 : OAUTH
                "lgSystem": "web",//登录系统，例如：‘android’，‘ios
                "lgIp": "111.203.241.52",//登录IP
                "lgStatus": 1,// 登录状态，1：成功，2：失败
                "lgInTime": 1598352251000//用户登录时间
            },
            {
                "id": 2323332,
                "uid": 2324288,//用户id
                "lgType": 1,//登录方式，1：手机号，2：邮件，3：微信，4：QQ，5：APP扫码登录
                "lgPlatform": 3,//登录平台，1：WEB，2：H5，3：APP ,4 : OAUTH
                "lgSystem": "web",//登录系统，例如：‘android’，‘ios
                "lgIp": "111.203.241.52",//登录IP
                "lgStatus": 1,// 登录状态，1：成功，2：失败
                "lgInTime": 1598352251000//用户登录时间
            }
        ]
    }
}

```

{% endtab %}
{% endtabs %}