API und Webhooks

Bestellungen an Warenwirtschaft, Buchhaltung oder Versanddienst übergeben.

Für Anbindungen an andere Programme gibt es eine Admin-API und Webhooks. Beides findest du unter Einstellungen.

API-Schlüssel

Unter Einstellungen → API-Schlüssel legst du einen Schlüssel mit den nötigen Rechten an (z. B. nur Bestellungen lesen). Der Schlüssel wird nur einmal angezeigt – speichere ihn sicher. Die API liegt unter /api/v1, der Schlüssel wird als Authorization: Bearer … mitgeschickt. Pro Schlüssel sind 120 Anfragen pro Minute erlaubt.

Typische Abfragen:

• GET /api/v1/orders – Bestellungen (filtern nach Status und Datum)
• GET /api/v1/orders/{nummer} – eine Bestellung mit Positionen
• POST /api/v1/orders/{nummer}/fulfillment – als versandt markieren
• GET /api/v1/products und GET /api/v1/products/{kürzel} – Produkte

Webhooks

Unter Einstellungen → Webhooks trägst du eine HTTPS-Adresse ein, und wählst die Ereignisse (Bestellung eingegangen, bezahlt, versandt oder storniert), bei denen der Shop eine Nachricht dorthin schickt. Jede Nachricht ist mit dem Geheimnis des Webhooks signiert (Kopfzeile X-Thimbly-Signature, HMAC-SHA256) – prüfe die Signatur in deinem Programm. Schlägt die Zustellung fehl, versucht es der Shop bis zu sechsmal mit wachsendem Abstand; den Verlauf siehst du im Webhook.