OpenAPI Specification

Die MORELO Dealer Suite API ist vollständig in OpenAPI 3.0 dokumentiert.

---

Swagger UI

Interaktive Dokumentation

Die OpenAPI Spec kann in Swagger UI oder Redoc geladen werden.

---

Spec herunterladen

• YAML: openapi.yaml
• JSON: Auf Anfrage

---

Schnellzugriff

Customers API

Method	Endpoint	Beschreibung
GET	/api/v1/customers	Liste aller Kunden
POST	/api/v1/customers	Neuen Kunden erstellen
GET	/api/v1/customers/{id}	Kunde abrufen
PUT	/api/v1/customers/{id}	Kunde aktualisieren
DELETE	/api/v1/customers/{id}	Kunde löschen

Products API

Method	Endpoint	Beschreibung
GET	/api/v1/products	Liste aller Produkte
POST	/api/v1/products	Neues Produkt erstellen
GET	/api/v1/products/{id}	Produkt abrufen

Devices API (E-Paper)

Method	Endpoint	Beschreibung
GET	/api/v1/devices	Liste aller Geräte
POST	/api/v1/devices	Gerät registrieren
GET	/api/v1/devices/{id}	Gerät abrufen
POST	/api/v1/devices/{id}/display	Display aktualisieren
POST	/api/v1/devices/{id}/reboot	Gerät neustarten

---

Authentifizierung

Alle Endpoints erfordern Bearer Token:

curl -X GET https://api.morelo-suite.de/v1/customers \
  -H "Authorization: Bearer {token}"

---

Base URLs

Environment	URL
Production	https://api.morelo-suite.de/v1
Development	http://localhost:8788/api/v1

---

Externe Integrationen

Die Suite nutzt primär externe APIs für Geschäftslogik:

Funktion	System	Docs
Termine	Microsoft Bookings	MS Bookings
CRM	Salesforce	Salesforce
Buchhaltung	sevDesk	sevDesk
Kalender/Mail	MS Graph	MS Graph

Die Suite-eigene API dient primär für:

• Customers: Lokaler Cache + Aggregation aus SF/MS Bookings
• Products: MORELO Fahrzeugdaten
• Devices: E-Paper Management

---

Code Generation

Mit der OpenAPI Spec können Clients generiert werden:

# TypeScript Client
npx openapi-typescript openapi.yaml -o ./types/api.ts

# Python Client
openapi-python-client generate --path openapi.yaml