API¶

Die HostAdmin REST API ermöglicht den programmatischen Zugriff auf alle wesentlichen Ressourcen des Systems.

Authentifizierung¶

Alle API-Endpunkte (ausser Stripe Webhook) erfordern einen Bearer Token im Authorization-Header:

Authorization: Bearer IHR_API_TOKEN

Der API-Token wird in den Einstellungen im Admin-Panel verwaltet.

Fehlende oder ungültige Tokens

401 Unauthorized -- Kein Token konfiguriert oder kein Token im Request
403 Forbidden -- Token ungültig

Basis-URL¶

https://ihre-domain.de/api/w5t

Stripe Webhook

Der Stripe Webhook verwendet einen eigenen Prefix und ist unter /api/stripe/webhook erreichbar.

Verfügbare Ressourcen¶

Ressource	Endpunkt	Beschreibung
Customers	`/api/w5t/customers`	Kundenverwaltung
Service Definitions	`/api/w5t/service-definitions`	Service-Vorlagen / Produkte
Customer Services	`/api/w5t/customer-services`	Kunden-Services
Servers	`/api/w5t/servers`	Serververwaltung
Invoices	`/api/w5t/invoices`	Rechnungen
Payments	`/api/w5t/payments`	Zahlungen
Stripe Webhook	`/api/stripe/webhook`	Stripe Event-Verarbeitung

Antwortformat¶

Alle Antworten werden als JSON zurückgegeben.

Erfolgreiche Erstellung (201):

{
  "message": "Customer created successfully",
  "customer": { ... }
}

Erfolgreiche Aktualisierung (200):

{
  "message": "Customer updated successfully",
  "customer": { ... }
}

Validierungsfehler (422):

{
  "message": "Validation failed",
  "errors": {
    "email": ["The email field is required."]
  }
}

Upsert-Verhalten¶

Die POST-Endpunkte (store) verwenden eine Upsert-Logik: Wird ein Datensatz mit dem gleichen eindeutigen Schlüssel gefunden, wird er aktualisiert statt neu erstellt.

Ressource	Upsert-Schlüssel
Customers	`customer_number`
Service Definitions	`article_number`
Customer Services	`service_number`
Servers	`server_number`
Invoices	`invoice_number`
Payments	`payment_reference`