Revised:
1. Wat het is
Met de WareRushAI REST API kunnen externe programma's de gegevens van één bedrijf uitlezen: producten, voorraad per locatie, bestellingen, producten met ontbrekende gegevens en marketplace-fouten. Deze versie is alleen-lezen en rust op dezelfde services en machtigingscontroles als de web-app en de MCP-connector. Het basisadres is https://app.warerushai.com/api/v1. De API wordt geleidelijk uitgerold: totdat deze voor het platform is geactiveerd, retourneert elke aanroep een 404-status en kunnen er geen sleutels worden aangemaakt.
2. Een API-sleutel aanmaken
Een eigenaar of beheerder opent Instellingen, vervolgens Integraties en daarna API-sleutels, geeft de sleutel een naam, kiest de machtigingen (catalog.read, inventory.read, orders.read, account.read), een verloopdatum en een limiet per minuut, en maakt deze aan. De volledige sleutel begint met wra_live_ en wordt slechts eenmalig getoond. WareRushAI bewaart uitsluitend een eenrichtingshash en de eerste tekens, waardoor een verloren sleutel niet kan worden hersteld: maak in dat geval een nieuwe aan. U kunt een sleutel op elk gewenst moment intrekken of roteren: de nieuwe sleutel wordt eenmalig getoond en de oude blijft nog 24 uur werken.
3. Authenticatie
Verstuur de sleutel in de Authorization-header: Authorization: Bearer wra_live_... via HTTPS. Plaats de sleutel nooit in het webadres; verzoeken die dit wel doen worden geweigerd met key_in_url. Voorbeeld: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". OAuth 2.1-toegangstokens van de MCP-connector worden ook geaccepteerd, inclusief de door de gebruiker goedgekeurde machtigingen.
4. Eindpunten
GET /me (de sleutel, limieten en het verbruik van vandaag), GET /products (zoeken en overzicht, met query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (voorraadregels, gepagineerd), GET /inventory/summary, GET /orders (met updated_since, status, source, limit, cursor), GET /missing-data en GET /marketplace-errors (met channel). Elk eindpunt vereist de bijbehorende machtiging: catalog.read voor producten, ontbrekende gegevens en marketplace-fouten, inventory.read voor locaties en voorraad, orders.read voor bestellingen. Alleen GET wordt ondersteund; andere methoden retourneren 405.
5. Paginering en polling
Lijsten retourneren data, next_cursor en has_more, met maximaal 50 items per pagina (limit 1 tot 50, standaard 20). Geef next_cursor weer mee als cursor om de volgende pagina op te halen. Voor polling-triggers in Zapier, Make en n8n roept u GET /orders?updated_since=2026-11-15T08:00:00Z aan en onthoudt u het tijdstip van uw laatste succesvolle poll: u ontvangt de bestellingen die sindsdien zijn aangemaakt of gewijzigd, de nieuwste eerst.
6. Limieten en fouten
Elke sleutel heeft een limiet per minuut (standaard 60, maximaal 600) en een optionele daglimiet. Elk bedrijf heeft daarnaast een dagelijks tegoed op basis van het abonnement: standaard 1.000 aanroepen voor Starter, 10.000 voor Business en 100.000 voor Pro. Wanneer een limiet wordt bereikt, antwoordt de API met 429 en een Retry-After-header. De headers X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit en X-Daily-Remaining tonen wat er over is. Fouten zien er altijd als volgt uit: {"error":{"code","message","request_id"}}; vermeld het request_id wanneer u contact opneemt met de ondersteuning. Veelvoorkomende codes: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited en daily_quota_exceeded (429).
7. OpenAPI-specificatie
De machineleesbare OpenAPI 3.1-specificatie is te vinden op https://app.warerushai.com/api/v1/openapi.json en vereist geen sleutel. Importeer deze in Postman, Zapier, Make, n8n of een AI-assistent om direct alle eindpunten, parameters en responsstructuren te laden. Wijzigingen worden doorgevoerd zonder bestaande velden te breken; de versie is /api/v1.
8. Beveiliging
Sleutels zijn gekoppeld aan exact één bedrijf en worden bij elke aanroep gecontroleerd; een sleutel kan nooit gegevens van een ander bedrijf inzien en stopt met werken zodra de beheerder die deze heeft aangemaakt het bedrijf verlaat. Sleutels verschijnen nooit in logs of foutmeldingen, en het aanroepenlogboek toont alleen het pad, de status en het tijdstip. Financiële gegevens zoals inkoopprijzen worden via deze API niet vrijgegeven.
