Technical:Back-end Server - Revision history

Evert: /* Server actions */

2026-01-18T15:46:10Z

Server actions

← Older revision		Revision as of 15:46, 18 January 2026
Line 20:		Line 20:

	* <code>/server</code>		* <code>/server</code>
	** <code>GET /</code> - Get the information about the current server		** <code>GET /</code> - Get the information about the current server. Returns a list of active user sessions, which should be cross-referenced to kick out players who were invalidated elsewhere.
			** <code>POST /reset</code> - Delete all dangling sessions for this server. Should be called upon clean shutdown and/or startup.
	** <code>/player</code>		** <code>/player</code>
	*** <code>POST /login</code> - Handles player login with user credentials. Issues session token. Returns user information.		*** <code>POST /login</code> - Handles player login with user credentials. Issues session token. Returns user information.
	*** <code>POST /join/<session></code> - Handles player login with a pre-issued session token and adjusts the expiry timing on the token. Returns user information.		*** <code>POST /join/<session></code> - Handles player login with a pre-issued session token and adjusts the expiry timing on the token. Returns user information.
	*** <code>GET /<id>/characters</code> - Get a list of the player's characters.
	*** <code>POST /logout/<session></code> - Handle player logout. Invalidates session token and releases any active character lock.		*** <code>POST /logout/<session></code> - Handle player logout. Invalidates session token and releases any active character lock.
			*** <code>GET /<id>/characters</code> - Get a list of the player's characters and their outfits.
	*** <code>/<id>/relationships</code>		*** <code>/<id>/relationships</code>
	**** <code>GET /</code> - List a player's relationships. Also includes pending friend requests, which the server will show only once to the recipient.		**** <code>GET /</code> - List a player's relationships. Also includes pending friend requests, which the server will show only once to the recipient.
Line 36:		Line 37:
	**** <code>PATCH /</code> - Update the party or its membership statuses.		**** <code>PATCH /</code> - Update the party or its membership statuses.
	**** <code>DELETE /</code> - Delete the party.		**** <code>DELETE /</code> - Delete the party.
	** <code>/character/</code>		** <code>/character</code>
	*** <code>POST /</code> - Create a new character, including starting inventory, statistics and outfits.		*** <code>POST /</code> - Create a new character, including starting inventory, statistics and outfits.
	*** <code>GET /<id></code> - Gets the full set of information about a player's character, including inventory, statistics and outfits.		*** <code>GET /<id></code> - Gets the full set of information about a player's character, including inventory, statistics and outfits.
Line 45:		Line 46:
	*** <code>POST /action</code> - Create a new moderation action.		*** <code>POST /action</code> - Create a new moderation action.
	*** <code>POST /report</code> - Create a new player report.		*** <code>POST /report</code> - Create a new player report.
			* <code>GET /servers</code> - Get a public list of servers. Does not include unlisted servers. This request does not require any authorization.

	=== Administration ===		=== Administration ===

Evert: /* Server actions */

2026-01-18T14:49:59Z

Server actions

Evert: /* User accounts */

2026-01-18T08:13:52Z

User accounts

← Older revision		Revision as of 08:13, 18 January 2026
Line 8:		Line 8:
	** <code>POST /register</code> - Create a new user account.		** <code>POST /register</code> - Create a new user account.
	** <code>POST /password/forgot</code> - Send "forgot password" email.		** <code>POST /password/forgot</code> - Send "forgot password" email.
	** <code>POST /password/reset</code> - Set a new password using a reset token.		** <code>POST /password/reset/<token></code> - Set a new password using a reset token.
			** <code>POST /activate/<token></code> - Activate user by token
	** <code>POST /login</code> - Create a new login session (cookie).		** <code>POST /login</code> - Create a new login session (cookie).
	** <code>GET /user</code> - Get current user information.		** <code>GET /user</code> - Get current user information.

Evert: /* User accounts */

2026-01-12T20:52:34Z

User accounts

← Older revision		Revision as of 20:52, 12 January 2026
Line 6:		Line 6:

	* <code>/auth</code>		* <code>/auth</code>
	** <code>POST /login</code> - Create a new login session (cookie)		** <code>POST /register</code> - Create a new user account.
	** <code>GET /user</code> - Get current user information		** <code>POST /password/forgot</code> - Send "forgot password" email.
	** <code>POST /logout</code> - Log out (invalidate cookie)		** <code>POST /password/reset</code> - Set a new password using a reset token.
			** <code>POST /login</code> - Create a new login session (cookie).
			** <code>GET /user</code> - Get current user information.
			** <code>PATCH /user</code> - Update user information.
			** <code>POST /logout</code> - Log out (invalidate cookie).
	** <code>POST /join/<id></code> - Issue a short-lived session token for a specific server by ID. Allows for the joining of a server without ever forwarding user credentials to it.		** <code>POST /join/<id></code> - Issue a short-lived session token for a specific server by ID. Allows for the joining of a server without ever forwarding user credentials to it.

Evert: Functionalities, model updates

2026-01-12T20:34:22Z

Functionalities, model updates

Show changes

Evert at 20:28, 10 January 2026

2026-01-10T20:28:47Z

← Older revision		Revision as of 20:28, 10 January 2026
Line 236:		Line 236:
	\|text		\|text
	\|NOT NULL		\|NOT NULL
	\|		\|Secret key used by game servers to contact the back-end
	\|-		\|-
	\|address		\|address
	\|text		\|text
	\|NOT NULL		\|NOT NULL
	\|		\|Connection address complete with the port
	\|-		\|-
	\|name		\|name
	\|text		\|text
	\|NOT NULL		\|NOT NULL
	\|		\|Public name for the server
			\|-
			\|rules
			\|text
			\|NOT NULL
			\|Individual server rules
	\|-		\|-
	\|listed		\|listed

Evert: Schema

2026-01-10T20:09:56Z

Schema

Show changes

Evert: Initial content

2026-01-10T19:17:15Z

Initial content

New page

Technical documentation for the back-end server. The back-end server is used by the website (https://trot.land/) for creating and managing user accounts and by game servers to persist player data.

← Older revision		Revision as of 14:49, 18 January 2026
Line 22:		Line 22:
	** <code>GET /</code> - Get the information about the current server		** <code>GET /</code> - Get the information about the current server
	** <code>/player</code>		** <code>/player</code>
	*** <code>POST /join</code> - Handles player login with a pre-issued session token and adjusts the expiry timing on the token. Returns user information.
	*** <code>POST /login</code> - Handles player login with user credentials. Issues session token. Returns user information.		*** <code>POST /login</code> - Handles player login with user credentials. Issues session token. Returns user information.
			*** <code>POST /join/<session></code> - Handles player login with a pre-issued session token and adjusts the expiry timing on the token. Returns user information.
	*** <code>GET /<id>/characters</code> - Get a list of the player's characters.		*** <code>GET /<id>/characters</code> - Get a list of the player's characters.
	*** <code>POST /<id>~~/logout~~</code> - Handle player logout. Invalidates session token and releases any active character lock.		*** <code>POST /logout/<session></code> - Handle player logout. Invalidates session token and releases any active character lock.
	*** <code>/<id>/relationships</code>		*** <code>/<id>/relationships</code>
	**** <code>GET /</code> - List a player's relationships. Also includes pending friend requests, which the server will show only once to the recipient.		**** <code>GET /</code> - List a player's relationships. Also includes pending friend requests, which the server will show only once to the recipient.
Line 36:		Line 36:
	**** <code>PATCH /</code> - Update the party or its membership statuses.		**** <code>PATCH /</code> - Update the party or its membership statuses.
	**** <code>DELETE /</code> - Delete the party.		**** <code>DELETE /</code> - Delete the party.
	** <code>/character</code>		** <code>/character/</code>
			*** <code>POST /</code> - Create a new character, including starting inventory, statistics and outfits.
	*** <code>GET /<id></code> - Gets the full set of information about a player's character, including inventory, statistics and outfits.		*** <code>GET /<id></code> - Gets the full set of information about a player's character, including inventory, statistics and outfits.
	*** <code>POST /<id>/~~switch~~</code> - Sets the character lock for a specific character (when player chooses the character they want to play as).		*** <code>POST /<id>/lock/<session></code> - Sets the character lock for a specific character (when player chooses the character they want to play as).
	*** <code>PATCH /<id></code> - Change character information. Can take up to a full set of information about a player's character. '''This is the main character persistence mechanism.'''		*** <code>PATCH /<id></code> - Change character information. Can take up to a full set of information about a player's character. '''This is the main character persistence mechanism.'''
	*** <code>DELETE /<id></code> - Player deleted their character.		*** <code>DELETE /<id></code> - Player deleted their character.