Zum Inhalt

API-Referenz

REST-API Dokumentation für OpenLibry.

Basis-URL

http://localhost:3000/api

Bücher

Alle Bücher abrufen

GET /api/book

Einzelnes Buch

GET /api/book/{id}

Buch anlegen

POST /api/book
Content-Type: application/json

{
  "title": "Der kleine Prinz",
  "author": "Antoine de Saint-Exupéry",
  "isbn": "978-3-15-010863-0"
}

Buch aktualisieren

PUT /api/book/{id}
Content-Type: application/json

{
  "title": "Neuer Titel"
}

Buch löschen

DELETE /api/book/{id}

Nutzer

Alle Nutzer

GET /api/user

Einzelner Nutzer

GET /api/user/{id}

Nutzer anlegen

POST /api/user
Content-Type: application/json

{
  "firstName": "Max",
  "lastName": "Mustermann",
  "schoolGrade": "3a"
}

Nutzer aktualisieren

PUT /api/user/{id}

Nutzer löschen

DELETE /api/user/{id}

Ausleihe

Buch ausleihen

POST /api/book/{buchId}/user/{userId}

Buch zurückgeben

DELETE /api/book/{buchId}/user/{userId}

Response-Format

Erfolgreiche Responses:

{
  "id": 1,
  "title": "...",
  ...
}

Fehler:

{
  "error": "Fehlermeldung"
}

HTTP-Statuscodes

Code Bedeutung
200 OK
201 Erstellt
400 Ungültige Anfrage
404 Nicht gefunden
500 Serverfehler