gorb/specifications
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Put proper token examples

Browse source
This commit is contained in:
SauceyRed 2025-04-28 23:30:23 +02:00
parent 23ac445713
commit 2891101286
No known key found for this signature in database
GPG key ID: 6AD2337BB02E657B
2 changed files with 70 additions and 68 deletions
Download patch file Download diff file Expand all files Collapse all files

47
API/client-server/v1/login.md
View file

@ -8,18 +8,18 @@ Authenticates the user, and issues an access token for future requests.
## Request
|Name|Type|Description|
|-|-|-|
|identifier|string|User's gorb ID. One of identifier and email **must** be implemented|
|email|string|User's email. One of identifier and email **must** be implemented|
|password|string|**Required**: The user's password (we need to figure out how exactly we're hashing + salting it on the client)|
|device_name|string|Name to help the user identify the device in their session list|
| Name | Type | Description |
| ----------- | ------ | -------------------------------------------------------------------------------------------------------------- |
| identifier | string | User's gorb ID. One of identifier and email **must** be implemented |
| email | string | User's email. One of identifier and email **must** be implemented |
| password | string | **Required**: The user's password (we need to figure out how exactly we're hashing + salting it on the client) |
| device_name | string | Name to help the user identify the device in their session list |
```json
{
"identifier": "radial_4740",
"password": "9r89mhs4czu4",
"device_name": "Laptop"
"identifier": "radial_4740",
"password": "9r89mhs4czu4",
"device_name": "Laptop"
}
```
@ -27,26 +27,27 @@ Authenticates the user, and issues an access token for future requests.
## Responses
|Status|Description|
|-|-|
|200|Authentication successful|
|400|The post request included poorly formated data|
|403|Part of the cridentials are invalid.|
| Status | Description |
| ------ | ---------------------------------------------- |
| 200 | Authentication successful |
| 400 | The post request included poorly formated data |
| 403 | Part of the cridentials are invalid. |
---
### 200
|Name|Type|Description|
|-|-|-|
|access_token|string|**Required**: The access token that will be used for further authentication|
|user_id|string|**Required**: The full gorb ID for the account|
|expires_in|int|How many seconds until the token expires and is invalidated|
| Name | Type | Description |
| ------------ | ------ | --------------------------------------------------------------------------- |
| access_token | string | **Required**: The access token that will be used for further authentication |
| user_id | string | **Required**: The full gorb ID for the account |
| expires_in | int | How many seconds until the token expires and is invalidated |
```json
{
"access_token": "gwLhWXD9wrqL3DwxXZ0VHUeOjr8am1yO",
"user_id": "@radial_4740:gorb.app",
"expires_in": 2592000
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJAcmFkaWFsXzQ3NDA6Z29yYi5hcHAiLCJpZGVudGlmaWVyIjoicmFkaWFsXzQ3NDAiLCJpYXQiOjE3NDM4ODgyNDAsImV4cCI6MTc0NTk2MTg0MH0.MZsOfeOm98K2sgtJ3hIDy0iyX27tDJRgW5iSayBJIDM",
"user_id": "@radial_4740:gorb.app",
"expires_in": 86400,
"refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJAcmFkaWFsXzQ3NDA6Z29yYi5hcHAiLCJpZGVudGlmaWVyIjoicmFkaWFsXzQ3NDAiLCJpYXQiOjE3NDM4ODgyNDAsImV4cCI6MTc0NjQ4MDI0MH0.OvUDelrhELNBhizvAj7wm13YpDLYluI4sPeBmT5sPUg"
}
```
```