跳到主要内容

UserLogin

---
sidebar_position: 2
---

# 用户登录

> 用于登录，系统将返回访问令牌

## 请求地址

- *API地址（请求URI）:* /openapi/v1/user/login

## 请求参数

| 参数名称            | 类型     | 要求     | 描述                                                                                                          |
|-------------------|---------|---------|--------------------------------------------------------------------------------------------------------------|
| bizName           | String  | O     | 业务名称，目前在信任业务前端需要                                                                                  |
| registerType      | Integer    | O     | 注册类型：1-电话号码，2-电子邮件，3-一键登录                                                                      |
| phoneNumberPrefix | Integer    | R     | 电话号码前缀，国家代码，例如，中国86，香港852，美国1                                                               |
| phoneNumber       | String  | R     | 电话号码                                                                                                      |
| email             | String  | R     | 电子邮件                                                                                                     |
| password          | String  | R     | 密码                                                                                                          |
| ip                | String  | O     | 登录时的IP地址                                                                                                 |
| countryId         | String  | O     | 登录时的国家/地区，输入国家代码，例如，香港-HK，美国-US，中国-CN                                              |
| deviceModel       | String  | O     | 设备型号                                                                                                      |

## 示例请求

```json
{
  "password": "XM6i/reK/8Yd14hPYsvwbtP7a4zWZ0m43+5MzuuXfD2RnU0NOCMmZiRHua7YsePAP4iBdUKGuER1hf5jhxZwXwmsh41+TBgsR46fKKW889Tdx4upmQVNlP7oquQAeqNHVxRzyfaBGSWEciaTjzPopGrQf5TnFEKBpAvINZ/m1yc=",
  "phoneNumberPrefix": "852",
  "phoneNumber": "98763237",
  "registerType": 1,
  "ip": "14.155.42.142",
  "countryId": "CN"
}

响应参数​

参数名称类型描述
idLong主键
uidStringUUID
bizCodeString业务代码
bizNameString业务名称
identificationLevelInteger认证级别
nicknameString基于电话号码或电子邮件生成的昵称
phoneNumberPrefixInteger电话号码前缀
phoneNumberString电话号码
emailString电子邮件地址
loginType (已弃用)String登录类型（已弃用）
registerTypeString注册类型（1- 电话，2- 电子邮件，3- 一键登录）
passwordString密码
birthdayLocalDate出生日期
countryIdString国家/地区ID
countryString国家名称
surnameString姓氏
middleNameString中间名
givenNameString名字
fullNameString全名
idTypeIdString证件类型ID
idNumberString证件号码
idTypeString证件类型
channelIdString渠道ID
inviterCodeString邀请者的邀请码
inviterNameString邀请者的姓名
customerManagerString指定的客户经理
cityString城市
addressString地址
streetString街道
houseNumberString门牌号
timeZoneString用户时区
createTimeLocalDateTime创建时间
updateTimeLocalDateTime最后更新时间（包括密码更新）
openAccountTimeLocalDateTime开户时间
userTypeTestInteger是否为测试账户（0- 否，1- 是）
grayScaleInteger是否为灰度账户（0- 否，1- 是）
statusInteger状态（0- 禁用，1- 启用）
registerIpString注册时的IP地址
lastLoginIpString上次登录的IP地址
lastLoginTimeLocalDateTime上次登录时间
lastLoginCountryString上次登录的国家
registerSourceInteger注册来源（0- 用户自注册，1- CRM管理员注册）信任业务有特殊用途，在客户经理补充信息后从0更改为1

示例响应​

{
  "code": "0",
  "msg": "ok",
  "data": {
    "id": 139061,
    "uid": "75b8ccad23f342c1a519718c7fb6c041",
    "bizCode": "98227698",
    "bizName": "MFT",
    "identificationLevel": null,
    "nickname": "98****37",
    "phoneNumberPrefix": 852,
    "phoneNumber": "98793237",
    "email": null,
    "loginType": "1",
    "registerType": "1",
    "password": "536e0a39a107e1319ad3894db4800410356af68313d16931",
    "birthday": null,
    "countryId": "HK",
    "country": "中国香港特别行政区",
    "surname": null,
    "middleName": null,
    "givenName": null,
    "fullName": null,
    "idTypeId": null,
    "idNumber": null,
    "idType": null,
    "channelId": null,
    "inviterCode": null,
    "inviterName": null,
    "customerManager": null,
    "city": null,
    "address": null,
    "street": null,
    "houseNumber": null,
    "timeZone": "UTC+8:00",
    "createTime": "2024-12-11T11:07:19.438744618",
    "updateTime": "2024-12-11T11:07:19.443132556",
    "openAccountTime": null,
    "userTypeTest": null,
    "grayScale": null,
    "status": null,
    "registerIp": "61.93.232.102",
    "lastLoginIp": "61.93.232.102",
    "lastLoginTime": null,
    "lastLoginCountry": "中国香港特别行政区",
    "registerSource": null
  },
  "success": true
}

示例代码​

OkHttpClient client = new OkHttpClient().newBuilder()
        .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"password\": \"XM6i/reK/8Yd14hPYsvwbtP7a4zWZ0m43+5MzuuXfD2RnU0NOCMmZiRHua7YsePAP4iBdUKGuER1hf5jhxZwXwmsh41+TBgsR46fKKW889Tdx4upmQVNlP7oquQAeqNHVxRzyfaBGSWEciaTjzPopGrQf5TnFEKBpAvINZ/m1yc=\",\r\n    \"phoneNumberPrefix\": \"852\",\r\n    \"phoneNumber\": \"98763237\",\r\n\t\"registerType\": 1,\r\n    \"ip\":\"14.155.42.142\",\r\n    \"countryId\":\"CN\"\r\n}");
Request request = new Request.Builder()
        .url("https://test-gateway.mcconnects.com/mc-crm/openapi/v1/user/login")
        .method("POST", body)
        .addHeader("token", "d425a12bdd2b58f59f079fcbb6d15e58")
        .addHeader("Content-Type", "application/json")
        .addHeader("Cookie", "token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJsb2dpblR5cGUiOiJsb2dpbiIsImxvZ2luSWQiOjEsImRldmljZSI6ImRlZmF1bHQtZGV2aWNlIiwiZWZmIjotMSwicm5TdHIiOiJYUkVaUERWdWVnNmFpYUUyTjIwS3hYVXVsaGlXdGdWTiIsInVzZXJNZXJjaGFudElkcyI6KioiLCJwZXJtaXNzSWQiOjEwMDAxLCJ1c2VybmFtZSI6ImFkbWluIn0.iXq5Kc1kHPhjm1mauj9vto8PD5A9dP-V5t3y2hp5FGI")
        .build();
Response response = client.newCall(request).execute();
}