# 用户信息接口

## 用户注册接口

<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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://platformv2docs.chainup.com/yong-hu-xin-xi-jie-kou.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.