Zum Inhalt

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

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