specifications/API/client-server/v1/register.md

POST /v1/register

---

Registers the user, and issues an access token for future requests.

---

Request

Name	Type	Description
identifier	string	Required User's desired ID.
email	string	Required User's email.
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.

{
  "identifier": "radial_4740",
  "email": "radial_4740@yahoo.com",
  "password": "9r89mhs4czu4",
  "device_name": "Laptop"
}

---

Responses

Status	Description
200	Registration successful.
400	The post request included poorly formated data.
403	Signups are disabled, gorb ID not available, email already in use, or password doesn't meet the minimum security requirements.

---

200

Name	Type	Description
access_token	string	Required: The JWT access token that will be used for further authentication.
user_id	string	Required: The account's local gorb ID.
uuid	string	Required: The account's UUID.
expires_in	int	How many seconds until the token expires and is invalidated.
refresh_token	string	The JWT refresh token that will be used to refresh the access token. Required for avoiding users having to log in after access token expiration.

{
  "access_token": "13aa5fe2ae5874fb9616e68c25632a146552584ac238a3e4ede08174fbfc4f45",
  "user_id": "radial_4740",
  "uuid": "dcb445f1-16e7-4cd9-ac19-af07acaeb865",
  "expires_in": 86400,
  "refresh_token": "8556a85b8912a78572cd67b21350e188039f656a0781dab20fab7b72a11d2a93"
}

---

403

Name	Type	Description
signups_enabled	bool	Does the server have signups enabled?
gorb_id_valid	bool	Is the given gorb ID even valid?
gorb_id_available	bool	Is the given gorb ID available?
email_valid	bool	Is the given email valid?
email_available	bool	Is the given email available?
password_minimum_length	bool	Is the given password long enough?
password_special_characters	bool	If enforced by the server, is there enough special characters in the password?
password_letters	bool	If enforced by the server, is there enough letters in the password?
password_numbers	bool	If enforced by the server, is there enough numbers in the password?

{
  "signups_enabled": true,
  "gorb_id_valid": true,
  "gorb_id_available": true,
  "email_valid": true,
  "email_available": false,
  "password_minimum_length": true,
  "password_special_characters": false,
  "password_letters": true,
  "password_numbers": true
}