PVV sitt biblI/Otek
This repository has been archived on 2024-08-20. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Peder Bergebakken Sundt 6e6c71dfc4
Merge pull request #2 from Programvareverkstedet/dependabot/npm_and_yarn/lodash-4.17.19
Bump lodash from 4.17.15 to 4.17.19
2020-12-15 10:34:40 +01:00
api Essential backend functionality, including logins. 2019-08-21 12:52:12 +02:00
utils Essential backend functionality, including logins. 2019-08-21 12:52:12 +02:00
.gitignore Initial commit 2019-08-21 10:26:52 +00:00
LICENSE Initial commit 2019-08-21 10:26:52 +00:00
README.md Added routes. 2019-08-21 11:08:03 +00:00
package-lock.json Merge pull request #2 from Programvareverkstedet/dependabot/npm_and_yarn/lodash-4.17.19 2020-12-15 10:34:40 +01:00
package.json Bump bcrypt from 3.0.6 to 5.0.0 2020-12-12 12:54:20 +00:00
server.js Essential backend functionality, including logins. 2019-08-21 12:52:12 +02:00

README.md

Biblio

RESTful API for PVV's library system (BiblI/Otek).

It's about time I put this up somewhere.

Currently assumes a running local MongoDB instance called "ils", with a password-protected admin user "ils_operator".

To run, type:

npm install
npm start [password]

ExpressJS is used for routing, bcrypt is used for passwords, mongoose is used to interface with MongoDB.

HATEOAS isn't implemented yet.

In lieu of Swagger:

GET /books: List all books in library.
POST /books: Add a book to the library. 

GET /books/:bookId : Get specific entry for a book.
PUT /books/:bookId : Requires update_books permission. Updates entry for book.
DELETE /books/:bookId : Requires delete_books permission. Deletes entry for book.

GET /users: List all users in library.
POST /users: Requires add_users permission. Add a user to the system. If any non-default permissions are needed, change_permissions is required.

GET /users/:userId : Get specific user entry.
PUT /users/:userId : Requires update_users permission. Updates user entry.
DELETE /users/:userId : Requires delete_users permission. Deletes user. Not allowed if user is currently borrowing any books.

GET /borrow: Requires borrow_books permission. Lists logged in user's borrowed books. 
PUT /borrow: Borrows a book, sent in the format { bookId: [id] }.
DELETE /borrow: Deletes a book, sent in the format { bookId: [id] }.