Submits a real-name registrant.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ClientToken |
string |
No |
Ensures the idempotency of the request. Generate a parameter value from your client to ensure uniqueness across different requests. ClientToken supports only ASCII characters and cannot exceed 64 characters. Note
If you do not specify this parameter, the system automatically uses the RequestId of the API request as the ClientToken. The RequestId may differ for each API request. |
eyJhbGciOiJIUzI1NiIsInR5cC..... |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Name |
string |
Yes |
The name of the registrant. The name cannot exceed 255 characters in length. |
Zhang XX |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| DocumentType |
string |
Yes |
The document type of the registrant.
|
SFZ |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| DocumentCode |
string |
Yes |
The document number of the registrant. The number cannot exceed 50 characters in length. |
110123456789122341 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
string |
Yes |
The email address. The address cannot exceed 300 characters in length. |
example@example.com |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| DocumentImage |
string |
Yes |
The document image of the registrant (base64-encoded). The original file size must be between 50 KB and 3 MB. |
Document image |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cc |
string |
Yes |
The country or region of the registrant. Specify a 2-character country or region code (refer to GB/T 2659.1-2022). |
CN |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| State |
string |
Yes |
The province of the registrant. The value cannot exceed 255 characters in length. If the country is China, the value must comply with GB/T 2260-2007. |
Zhejiang |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| City |
string |
Yes |
The city of the registrant. The value cannot exceed 255 characters in length. If the country is China, the value must comply with GB/T 2260-2007. |
Hangzhou |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Street |
string |
No |
The address of the registrant. The value cannot exceed 255 characters in length. |
XX District, XX Street |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Phone |
string |
Yes |
The phone number of the registrant. The value cannot exceed 128 characters in length. If the country is China and the number is not a mobile phone number, the area code must match the city. |
13112345678 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
The request ID. |
536E9CAD-DB30-4647-AC87-AA5CC38C5382 |
| RegistrantId |
string |
The ID of the real-name registrant. |
2072277378616354816 |
| Name |
string |
The name of the real-name registrant. |
Zhang XX |
| Status |
string |
The real-name verification status. Valid values:
|
Approved |
| CreateTimestamp |
integer |
The creation time (timestamp). |
1527690629357 |
| AccessDeniedDetail |
object |
The details of the access denial. This field is returned only when RAM authentication fails. |
|
| AuthAction |
string |
The unauthorized operation that was attempted. |
CreateUser |
| AuthPrincipalDisplayName |
string |
The display name of the authorization principal. |
2015555733387XXXX |
| AuthPrincipalOwnerId |
string |
The owner ID of the authorization principal. |
10469733312XXX |
| AuthPrincipalType |
string |
The identity type. |
SubUser |
| EncodedDiagnosticMessage |
string |
The encrypted diagnostic message. |
AQEAAAAAaNIARXXXXUQwNjE0LUQzN0XXXXVEQy1BQzExLTMzXXXXNTkxRjk1Ng== |
| NoPermissionType |
string |
The reason for the authentication failure. Valid values:
|
ImplicitDeny |
| PolicyType |
string |
The policy type. |
DlpSend |
Examples
Success response
JSON format
{
"RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
"RegistrantId": "2072277378616354816",
"Name": "张xx",
"Status": "审核通过",
"CreateTimestamp": 1527690629357,
"AccessDeniedDetail": {
"AuthAction": "CreateUser",
"AuthPrincipalDisplayName": "2015555733387XXXX",
"AuthPrincipalOwnerId": "10469733312XXX",
"AuthPrincipalType": "SubUser",
"EncodedDiagnosticMessage": "AQEAAAAAaNIARXXXXUQwNjE0LUQzN0XXXXVEQy1BQzExLTMzXXXXNTkxRjk1Ng==",
"NoPermissionType": "ImplicitDeny",
"PolicyType": "DlpSend"
}
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.