mirror of
https://github.com/cadmium-im/cadmium-docs-legacy.git
synced 2024-09-19 19:41:30 +00:00
107 lines
1.7 KiB
Markdown
107 lines
1.7 KiB
Markdown
# Account login by username
|
|
|
|
## Introduction
|
|
|
|
This extension is intended for logging into user account on a server by username
|
|
|
|
## Message type identifiers
|
|
|
|
- `profile:login`
|
|
|
|
## Errors
|
|
|
|
- Ratelimit system: enabled
|
|
- `invalid_creds`: user ID/password isn't valid
|
|
|
|
## Use cases
|
|
|
|
- Request:
|
|
|
|
```json
|
|
{
|
|
"id": "abcd",
|
|
"type": "profile:login",
|
|
"to": "cadmium.org",
|
|
"payload": {
|
|
"username": "juliet",
|
|
"password": "romeo1"
|
|
}
|
|
}
|
|
```
|
|
|
|
- Response:
|
|
|
|
```json
|
|
{
|
|
"id": "abcd",
|
|
"type": "profile:login",
|
|
"from": "cadmium.org",
|
|
"ok": true,
|
|
"payload": {
|
|
"authToken": "3b5135a5-aff5-4396-a629-a254f383e82f",
|
|
"deviceID": "ABCDEFG"
|
|
}
|
|
}
|
|
```
|
|
|
|
- Error response:
|
|
|
|
```json
|
|
{
|
|
"id": "abcd",
|
|
"type": "profile:login",
|
|
"from": "cadmium.org",
|
|
"ok": false,
|
|
"payload": {
|
|
"errID": "invalid_creds",
|
|
"errText": "Username/password isn't valid"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Business Rules
|
|
|
|
None.
|
|
|
|
## JSON Schema
|
|
|
|
### Payload
|
|
|
|
- Request:
|
|
|
|
```typescript
|
|
interface LoginRequestPayload {
|
|
/**
|
|
* The username of account which user wants to login (can be omit if we set thirdPID)
|
|
*/
|
|
username: string,
|
|
|
|
/**
|
|
* Third party ID which have user (can be omit if we set username)
|
|
*/
|
|
thirdPID: string,
|
|
|
|
/**
|
|
* Password of new account
|
|
*/
|
|
password: string
|
|
}
|
|
```
|
|
|
|
- Response:
|
|
|
|
```typescript
|
|
interface LoginResponsePayload {
|
|
/**
|
|
* Authentication token which required for various user actions (static SHA256 hash string from 4096 random characters)
|
|
*/
|
|
authToken: string,
|
|
|
|
|
|
/**
|
|
* Identifier of new user device (created by this login action)
|
|
*/
|
|
deviceID: string
|
|
}
|
|
```
|