POST
/api/user/login作业提交API文档.mdParaCloud API文档.pdf
用户登录接口 #1
差异《作业提交API文档.md》（2024/5/10）记录 4 个请求参数，《ParaCloud API文档.pdf》记录 25 个；本文采用前者。
请求示例: javascript { "password": "", "username": "", "verifyCode": "" }
请求参数 4
| 参数名称 | 参数说明 | 位置 | 必须 | 类型 |
|---|---|---|---|---|
| loginParam | LoginParam | body | true | LoginParam |
| password | 密码 | true | string | |
| username | 用户名 | true | string | |
| verifyCode | 验证码（如果没有启动验证，可忽） | false | string |
响应状态
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | successfully | VoUserGroup |
| 201 | Created | |
| 401 | You are not authorized to view the resource | |
| 403 | Accessing the resource you were trying to reach is forbidden | |
| 404 | The resource you were trying to reach is not found | |
| 500 | error | |
| 50001 | 登录剩余尝试次数。示例：{"code":50001,"msg":"剩余尝试次数","params":["4"]} | |
| 50002 | 验证码错误 | |
| 50004 | 认证错误（账号密码不匹配） | |
| 50097 | 账号已被锁住 |
响应参数（33）
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| accountExpireRemind | boolean | ||
| accountExpireRemindDay | integer(int64) | integer(int64) | |
| accountExpires | string(date-time) | string(date-time) | |
| allowDownload | boolean | ||
| changePassword | boolean | ||
| createdDate | 创建时间 | string(date-time) | string(date-time) |
| description | string | ||
| disable | 是否禁用用户 | boolean | |
| disableDate | string(date-time) | string(date-time) | |
| string | |||
| expandDateFirst | string(date-time) | string(date-time) | |
| expandFirst | string | ||
| expandSecond | string | ||
| gid | integer(int64) | integer(int64) | |
| groupNme | string | ||
| homeDirectory | string | ||
| id | integer(int64) | integer(int64) | |
| init | boolean | ||
| isDeleted | boolean | ||
| passwordExpires | string(date-time) | string(date-time) | |
| quotaMonthCpuTimeConsume | integer(int64) | integer(int64) | |
| quotaMonthCpuTimeTotal | integer(int64) | integer(int64) | |
| quotaMonthGpuTimeConsume | integer(int64) | integer(int64) | |
| quotaMonthGpuTimeTotal | integer(int64) | integer(int64) | |
| resign | boolean | ||
| resignDate | string(date-time) | string(date-time) | |
| roleId | 角色id | integer(int64) | integer(int64) |
| sid | string | ||
| uid | 用户uid | string | |
| updatedDate | 更新时间 | string(date-time) | string(date-time) |
| userScope | 可用值:EXTERNAL,INTERNAL | string | |
| userSecurityLevel | 可用值:CORE,GENERAL,IMPORTANT,NONE | string | |
| username | string |
响应示例
json
{
"accountExpireRemind": true,
"accountExpireRemindDay": 0,
"accountExpires": "",
"allowDownload": true,
"changePassword": true,
"createdDate": "",
"description": "",
"disable": true,
"disableDate": "",
"email": "",
"expandDateFirst": "",
"expandFirst": "",
"expandSecond": "",
"gid": 0,
"groupNme": "",
"homeDirectory": "",
"id": 0,
"init": true,
"isDeleted": true,
"passwordExpires": "",
"quotaMonthCpuTimeConsume": 0,
"quotaMonthCpuTimeTotal": 0,
"quotaMonthGpuTimeConsume": 0,
"quotaMonthGpuTimeTotal": 0,
"resign": true,
"resignDate": "",
"roleId": 0,
"sid": "",
"uid": "",
"updatedDate": "",
"userScope": "",
"userSecurityLevel": "",
"username": ""
}请求示例
json
{
"password": "",
"username": "",
"verifyCode": ""
}Java / OkHttp 示例
java
import okhttp3.*;
import java.io.IOException;
public class Main {
public static void main(String[] args) throws IOException {
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n \"password\": \"xxx\",\r\n \"username\": \"xxx\"\r\n}");
Request request = new Request.Builder()
.url("https://pc.paratera.com:10443/api/user/login")
.method("POST", body)
.addHeader("Content-Type", "application/json")
.addHeader("Cookie", "PAA_TOKEN=CC98603D656B4369B56CE9AB76FA50CEPCADMIN_1717659651692; SESSION=YWE5MzY5YjAtODM0Ni00MzY5LWE2ZmEtMTQ0YWQxZGQ2YmZk")
.build();
Response response = client.newCall(request).execute();
System.out.println("response = " + response.toString());
}
}Python / requests 示例
python
import requests
import json
url = "https://pc.paratera.com:10443/api/user/login"
payload = json.dumps({
"password": "xxx",
"username": "xxx"
})
headers = {
'Content-Type': 'application/json',
'Cookie': 'PAA_TOKEN=CC98603D656B4369B56CE9AB76FA50CEPCADMIN_1717659651692; SESSION=YWE5MzY5YjAtODM0Ni00MzY5LWE2ZmEtMTQ0YWQxZGQ2YmZk'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)