Notio REST API

Vollständige API-Dokumentation für Entwickler

Version 1.0
REST
JSON

Base URL

Alle API-Anfragen verwenden diese Base URL

In Entwicklung
https://notio.schächner.de/api
Verfügbar
http://localhost:9002/api

⚠️ Wichtiger Hinweis: Die Production API über die Domain ist aktuell noch nicht verfügbar. Für die Entwicklung und Tests verwende bitte die lokale API-Instanz (http://localhost:9002/api). Die Production-Bereitstellung erfolgt in Kürze.

Authentication

Authentifizierung mit Email und Passwort. Das ID-Token ist 1 Stunde gültig.

POST
/api/auth/login

Login mit Email und Passwort. Gibt ID-Token und Refresh-Token zurück.

curl -X POST "https://notio.schächner.de/api/auth/login" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "password123"
  }'

Response:

{
  "idToken": "eyJhbGci...",
  "refreshToken": "AIwUaOm...",
  "expiresIn": "3600",
  "localId": "user123",
  "email": "user@example.com"
}
POST
/api/auth/refresh

Token erneuern wenn abgelaufen.

curl -X POST "https://notio.schächner.de/api/auth/refresh" \
  -H "Content-Type: application/json" \
  -d '{
    "refreshToken": "AIwUaOm..."
  }'
POST
/api/auth/verify

Token validieren und User-Info abrufen.

curl -X POST "https://notio.schächner.de/api/auth/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "idToken": "eyJhbGci..."
  }'

Authorization Header

Alle geschützten Endpoints benötigen einen Bearer Token

Authorization: Bearer eyJhbGci...

Füge diesen Header bei allen Requests an geschützte Endpoints hinzu.

HTTP Status Codes

200
Erfolgreiche Anfrage
201
Ressource erfolgreich erstellt
400
Ungültige Anfrage (fehlende Felder)
401
Nicht authentifiziert (Token fehlt/ungültig)
403
Keine Berechtigung (z.B. fremder Post)
404
Ressource nicht gefunden
500
Serverfehler

Support & Kontakt

Bei Fragen zur API kontaktiere uns unter benedikt@schächner.de