update docs.md

This commit is contained in:
leca 2024-06-21 13:05:19 +03:00
parent d163edf942
commit 0527193add
1 changed files with 45 additions and 0 deletions

45
docs.md
View File

@ -1,75 +1,120 @@
# Docs for smk-chat # Docs for smk-chat
## API ## API
### /api/getCredentialsById/:userId ### /api/getCredentialsById/:userId
IN: _userId_ (in route) IN: _userId_ (in route)
OUT: _lastname_, _firstname_, _middlename_ OUT: _lastname_, _firstname_, _middlename_
Return credentials of the user whose id is userId. Return credentials of the user whose id is userId.
Return -1 if no such user exist. Return -1 if no such user exist.
Requires client to be logged in. Requires client to be logged in.
### /api/getIdByCredentials ### /api/getIdByCredentials
IN: _lastname_, _firstname_, _middlename_ IN: _lastname_, _firstname_, _middlename_
OUT: _UserID_ OUT: _UserID_
Returns an ID of the user, whose lastname, firstname and middlename were passed. Returns an ID of the user, whose lastname, firstname and middlename were passed.
Returns -1 if user does not exist. Returns -1 if user does not exist.
Requires client to be logged in. Requires client to be logged in.
### /api/getMessagesFromChat/by-amount ### /api/getMessagesFromChat/by-amount
IN: _chatId_, _amount_ IN: _chatId_, _amount_
OUT: array of objects that represent a message, like {"author_id": ..., time_sent: ..., content: ...} OUT: array of objects that represent a message, like {"author_id": ..., time_sent: ..., content: ...}
Returns an array of last _amount_ ordered by date of described objects if everything is okay Returns an array of last _amount_ ordered by date of described objects if everything is okay
Returns HTTP/1.1 400 "Chat with id _ID_ does not exist." if no chat with supplied id does not exist. Returns HTTP/1.1 400 "Chat with id _ID_ does not exist." if no chat with supplied id does not exist.
Returns HTTP/1.1 403 "You are not a member of this chat" if the statement is true ;) Returns HTTP/1.1 403 "You are not a member of this chat" if the statement is true ;)
Requires client to be logged in. Requires client to be logged in.
### /api/getMessagesFromChat/by-time ### /api/getMessagesFromChat/by-time
IN: _chatId_, _fromTimestamp_, _toTimestamp_ IN: _chatId_, _fromTimestamp_, _toTimestamp_
OUT: array of objects that represent a message, like {"author_id": ..., time_sent: ..., content: ...} OUT: array of objects that represent a message, like {"author_id": ..., time_sent: ..., content: ...}
_fromTimestamp_ must be lower that _toTimestamp_, otherwise it might return nothing. _fromTimestamp_ must be lower that _toTimestamp_, otherwise it might return nothing.
Returns an array of described objects if everything is okay Returns an array of described objects if everything is okay
Returns HTTP/1.1 400 "Chat with id _ID_ does not exist." if no chat with supplied id does not exist. Returns HTTP/1.1 400 "Chat with id _ID_ does not exist." if no chat with supplied id does not exist.
Returns HTTP/1.1 200 and an empty string if no messages in chat are found /shrug. Returns HTTP/1.1 200 and an empty string if no messages in chat are found /shrug.
Requires client to be logged in. Requires client to be logged in.
### /api/getChats ### /api/getChats
IN: _UserID_ IN: _UserID_
OUT: Array of chat IDs OUT: Array of chat IDs
Returs an array with ids of chats which user with passed ID is member in. Returs an array with ids of chats which user with passed ID is member in.
Return empty string if user has no membership in any chat. Return empty string if user has no membership in any chat.
Requires client to be logged in. Requires client to be logged in.
### /api/getChatInfo/:chatId ### /api/getChatInfo/:chatId
IN: _chatId_ (in route) IN: _chatId_ (in route)
OUT: JSON describes a chat with id: {name: ..., admins: ..., members: ...} OUT: JSON describes a chat with id: {name: ..., admins: ..., members: ...}
Note: JSON does not include messages. You have to use __/api/getMessagesFromChat__ to query messages. Note: JSON does not include messages. You have to use __/api/getMessagesFromChat__ to query messages.
Returns aforementioned json if the chat exists and user is a member of this chat. Returns aforementioned json if the chat exists and user is a member of this chat.
Returns -1 if chat does not exist Returns -1 if chat does not exist
Return -2 if user is not a member of the chat Return -2 if user is not a member of the chat
Requires client to be logged in. Requires client to be logged in.
### /api/createChat ### /api/createChat
IN: _UserId_, array of UserIDs that are to be invited. IN: _UserId_, array of UserIDs that are to be invited.
OUT: "Ok" if successful, "User with id _MEMBERID_ does not exist." OUT: "Ok" if successful, "User with id _MEMBERID_ does not exist."
Return -1 if amout of users to invite is 0. Return -1 if amout of users to invite is 0.
Requires client to be logged in Requires client to be logged in
### /api/logout ### /api/logout
IN: none. IN: none.
OUT: redirect to __/login__. OUT: redirect to __/login__.
Removes client's session, thus unlogging a user. Removes client's session, thus unlogging a user.
Requires client to be logged in. Requires client to be logged in.
### /api/register ### /api/register
IN: _lastname_, _firstname_, _middlename_, _password_ IN: _lastname_, _firstname_, _middlename_, _password_
OUT: redirect to __/__ OUT: redirect to __/__
Checks if user exist. If so, returns 400 with response "Such user exists.". Checks if user exist. If so, returns 400 with response "Such user exists.".
Otherwise, registers a user with given data. Otherwise, registers a user with given data.
Requires clinet to be not logged in. Requires clinet to be not logged in.
### /api/login ### /api/login
IN: _lastname_, _firstname_, _middlename_, _password_ IN: _lastname_, _firstname_, _middlename_, _password_
OUT: redirect to __/__ OUT: redirect to __/__
Checks if user exists. If not, returns 400 with response "No such user.". Checks if user exists. If not, returns 400 with response "No such user.".
Otherwise, compares passwords Otherwise, compares passwords
If passwords match, creating session and redirects to __/__ If passwords match, creating session and redirects to __/__
Requires client to be not logged in. Requires client to be not logged in.