Skip to content

Team-Sigma-Stern/api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

API

This is the Backend of the online Texteditor

Start

env FLASK_APP=main.py flask run -h 0.0.0.0 -p 5090090

Folders

To be Fix ed

`./global` # **root** Only for development, in production probaly some where in /usr/share

|-Projects project Folder

|-/$projectname

Api calls

Paths

/
/login POST: Login User. request body: { "name":...",password:"..." } answer body:{ "name":"...", "display-name":"...","auth-token":"..."}
/logout POST
/projects GET: List projects

/projects/<project name>
/projects/<project name>/files GET: List Files
/projects/<project name>/files/<file name> GET: Gets the content of <file name> POST: Sets the content of <file name>. If the file allready exists, it's need to be locked DELETE Deletes files, needs to be locked
/projects/<project name>/files/<file name>/lock GET: Is the file locked response:{"locked":"You | Other | No "} POST: Locks the file
/projects/<project name>/files/<file name>/unlock POST: unlocks the file

Header

*"auth-token" the token used for authentification

Codes

http codes used by the API

Code Case Response
200 Get Succesfull standard
201 POST Succesfull standard
204 Get Request to / none
400 User Request couldnt processed successfully Error response
401 No auth-token provided and request forbbiden for public or token expired none
403 The file, the client tryed ti write to, was not locked none
404 Resources not existing or The authentified user has no acces rights none
501 This feature is not implemented, but will be none

###Error response

Will be the response if an Error occured

{
"message":".." should be shown to the user
}

Roles

admin can change project
user can change files
guest can view files

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published