Revised:
1. Worum es sich handelt
Über die WareRushAI REST-API können externe Programme die Daten eines Unternehmens auslesen: Produkte, Bestände pro Standort, Bestellungen, Produkte mit unvollständigen Daten sowie Fehler bei Marktplatz-Listings. In dieser Version ist die API rein lesend und basiert auf denselben Services und Berechtigungsprüfungen wie die Web-App und der MCP-Connector. Die Basisadresse lautet https://app.warerushai.com/api/v1. Die API wird schrittweise freigeschaltet: Bis sie für die Plattform aktiviert wird, gibt jeder Aufruf 404 zurück und es können keine Schlüssel erstellt werden.
2. Einen API-Schlüssel erstellen
Ein Inhaber oder Administrator öffnet Einstellungen, dann Integrationen, dann API-Schlüssel, benennt den Schlüssel, wählt die Berechtigungen (catalog.read, inventory.read, orders.read, account.read), eine Gültigkeitsdauer sowie ein Minutenlimit und erstellt ihn. Der vollständige Schlüssel beginnt mit wra_live_ und wird nur ein einziges Mal angezeigt. WareRushAI speichert nur einen Einweg-Hash und die ersten Zeichen. Ein verlorener Schlüssel kann daher nicht wiederhergestellt werden – erstellen Sie in diesem Fall einen neuen. Sie können einen Schlüssel jederzeit widerrufen oder rotieren: Der neue Schlüssel wird einmalig angezeigt und der alte bleibt 24 Stunden lang aktiv.
3. Authentifizierung
Übertragen Sie den Schlüssel im Authorization-Header: Authorization: Bearer wra_live_... über HTTPS. Fügen Sie den Schlüssel niemals in die URL ein; solche Anfragen werden mit key_in_url abgewiesen. Beispiel: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". OAuth 2.1-Zugriffstoken des MCP-Connectors werden mit den vom Benutzer autorisierten Rechten ebenfalls akzeptiert.
4. Endpunkte
GET /me (der Schlüssel, Limits und heutige Nutzung), GET /products (Suche und Liste mit query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (Bestandszeilen, paginiert), GET /inventory/summary, GET /orders (mit updated_since, status, source, limit, cursor), GET /missing-data und GET /marketplace-errors (mit channel). Jeder Endpunkt erfordert die entsprechende Berechtigung: catalog.read für Produkte, unvollständige Daten und Marktplatzfehler; inventory.read für Standorte und Bestände; orders.read für Bestellungen. Es wird nur GET unterstützt; andere Methoden geben 405 zurück.
5. Paginierung und Polling
Listen liefern data, next_cursor und has_more zurück, mit maximal 50 Einträgen pro Seite (limit 1 bis 50, Standardwert 20). Übergeben Sie next_cursor als cursor, um die nächste Seite abzurufen. Für Polling-Trigger in Zapier, Make und n8n rufen Sie GET /orders?updated_since=2026-11-15T08:00:00Z auf und merken sich den Zeitpunkt der letzten erfolgreichen Abfrage: Sie erhalten alle seither erstellten oder geänderten Bestellungen, die neuesten zuerst.
6. Limits und Fehlerbehandlung
Jeder Schlüssel verfügt über ein Minutenlimit (Standard 60, maximal 600) und ein optionales Tageslimit. Jedes Unternehmen hat zudem ein tägliches Kontingent je nach Tarif: standardmäßig 1.000 Aufrufe für Starter, 10.000 für Business und 100.000 für Pro. Bei Erreichen eines Limits antwortet die API mit 429 und einem Retry-After-Header. Die Header X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit und X-Daily-Remaining zeigen das verbleibende Kontingent an. Fehler strukturieren sich stets als {"error":{"code","message","request_id"}}; geben Sie bei Support-Anfragen die request_id an. Häufige Fehlercodes: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited und daily_quota_exceeded (429).
7. OpenAPI-Beschreibung
Die maschinenlesbare OpenAPI 3.1-Spezifikation steht unter https://app.warerushai.com/api/v1/openapi.json bereit und erfordert keinen Schlüssel. Importieren Sie sie in Postman, Zapier, Make, n8n oder einen KI-Assistenten, um alle Endpunkte, Parameter und Antwortformate einzusehen. Änderungen erfolgen rückwärtskompatibel zu bestehenden Feldern; die Versionierung lautet /api/v1.
8. Sicherheit
Schlüssel sind fest an genau ein Unternehmen gebunden und werden bei jedem Aufruf validiert; ein Schlüssel kann niemals Daten eines anderen Unternehmens lesen und verliert seine Gültigkeit, wenn der erstellende Administrator das Unternehmen verlässt. Schlüssel erscheinen weder in Protokollen noch in Fehlermeldungen. Das Aufrufprotokoll erfasst ausschließlich Pfad, Status und Uhrzeit. Finanzdaten wie Einkaufspreise werden über diese API nicht offengelegt.
