yetangitu/timelimit-server
1
0
Fork 0
mirror of https://codeberg.org/timelimit/timelimit-server.git synced 2025-10-05 19:42:39 +02:00
Code Issues Projects Releases Wiki Activity

Add account deletion API

Browse source
This commit is contained in:
Jonas Lochmann 2023-04-03 02:00:00 +02:00
parent 05fac79849
commit e46f5bea3f
No known key found for this signature in database
GPG key ID: 8B8C9AEE10FA5B36
20 changed files with 705 additions and 119 deletions
Download patch file Download diff file Expand all files Collapse all files

24
docs/api/parent.md
View file

@ -194,3 +194,27 @@ If the ``secondPasswordHash`` is invalid: HTTP status code 401 Unauthorized
If the server does not support this request: HTTP status code 404
On success: ``{"token": "some string"}``; you should not make any assumptions about the token string
## POST /parent/delete-account
Use this to delete an account. This includes the complete family registration
with users and devices. Due to that, all parents with a linked mail address
have to authenticate this action.
## request
see [this JSON schema](../schema/deleteaccountpayload.md)
## response
On success: HTTP status code 200
On a invalid request body: HTTP status code 400 Bad Request
On unknown device auth token: HTTP status code 401 Unauthorized
On missing parent authentication: HTTP status code 401 Unauthorized
On unrelated parent authentication: HTTP status code 401 Unauthorized
If a newer endpoint must be used/the client is too old: HTTP status code 410 Gone