Customer Identity (CIAM)
Get User Details by Mobile Number
# Request Specification
POST https://{your_domain}/api/v2/tenant/users/user-by-mobile
# Request Headers
| Parameter Name | Chinese Name | Required | Type | Description |
|---|---|---|---|---|
| Authorization | Authorization | Yes | String | Format: Bearer {access_token} |
| Content-Type | Content-Type | Yes | String | Fixed value: application/json; charset=utf-8 |
# Request Example
{
"mobile":"13800001111"
}
1
2
3
2
3
# Request Parameters
| Parameter Name | Chinese Name | Required | Type | Description |
|---|---|---|---|---|
| mobile | Mobile Number | Yes | String |
# Return Example
Correct Example:
HTTP/1.1 200 OK
Content-Type: application/json
{
"user_name":"zhangsan",
"user_id":"20220126153857263-A04D-60E0D446C",
"name":"张三",
"mobile":"15200000000",
"email":"15200000000@qq.com",
"pwd_change_at":"2022-02-15 12:23:23",
"created_at":"2022-02-10 12:23:23",
"updated_at":"2022-02-15 12:23:23",
"disabled":false,
"attr_gender":"male",
"attr_birthday":"2022-02-17",
"attr_nick_name":"张三",
"mailing_address":"湖北省武汉市",
"zip_code":"430000",
"first_name":"",
"middle_name":"",
"last_name":"",
"industry":"事业单位",
"external_id":"12345678741d29069abcdef089d4q87sk12",
"usr_auth_times":"4",
"usr_last_login":"2022-02-17 13:00:25",
"extension": {
"age":"28"
},
"head_img": "https://........"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# Return Parameters
| Parameter Name | Chinese Name | Type | Description |
|---|---|---|---|
| user_name | Username | String | |
| user_id | User ID | String | |
| name | Full Name | String | |
| mobile | Mobile Number | String | |
| String | |||
| pwd_change_at | Password Change Time | String | |
| created_at | User Creation Time | String | |
| updated_at | User Modification Time | String | |
| disabled | Whether Disabled | String | |
| attr_gender | Gender | String | "unknow":Undisclosed "male":Male "female":Female |
| attr_birthday | Birthday | String | Format: yyyy-mm-dd |
| attr_nick_name | Nickname | String | |
| mailing_address | Mailing Address | String | |
| zip_code | Postal Code | String | |
| first_name | First Name | String | |
| middle_name | Middle Name | String | |
| last_name | Last Name | String | |
| industry | Industry | String | |
| external_id | External ID | String | |
| usr_auth_times | Login Count | Number | |
| usr_last_login | Last Login Time | String | |
| extension | Extended Attributes | JSONObject | |
| head_img | User Avatar URL | String |
# Error Codes
| Status Code | Error Code | Error Message | Handling Measures |
|---|---|---|---|
| 400 | IDAAS.TENANT.USER.0001 | User not found | Please check if the corresponding user exists |
| 用户未找到 | |||
| 400 | IDAAS.TENANT.USER.0020 | The mobile number does not meet the verification rules | Please check if the mobile number field in the input parameters complies with the verification rules for the mobile number field in 【Enterprise Center - Users - User Attribute Definition】 |
| 手机号不符合校验规则 | |||
| 400 | IDAAS.TENANT.MOBILE.0002 | An unauthenticated cell mobile number | Please check if 【Enterprise Center - Enterprise Configuration - International Dialing Code Configuration】 complies with the configuration rules |
| 未经认证的手机号 |