For whom: developer and administrator.
Required rights: Panel administrator account.
Two Ways to Transfer a Session
For integrations, use Bearer – it is not dependent on cookies and is not subject to browser checks.
Requests with cookies that change data (
POST, PUT, PATCH, DELETE) are verified by the source: the header Origin or Referer must match the address of the panel. Requests with Authorization: Bearer do not pass this check and do not break because of it.Entry and receipt of the token
Send your login and password to the login method:If the account has 2FA enabled, the first request will return
401 with the code TOTP_REQUIRED. Repeat the request by adding the totp_code field to the body.Use of the token
Transfer the token in the titleAuthorization:
Conclusion of the session
Authentication errors
Resetting the administrator password
If access to the panel is lost, the password is reset from the command line on the server (the action requires permissions on the server and is recorded in the audit):Verification
A request to
GET /api/v1/auth/me with your token returns the current administrator data and the status of 200.Rollback
Tokens are recalled by an exit (logout) or reset of the account password, after which the previous sessions cease to operate.