Viri

Javni REST API za WareRushAI (samo za branje)

Preberite svoje izdelke, zalogo, naročila, manjkajoče podatke in napake na tržnicah iz orodij Zapier, Make, n8n ali lastne kode z API-ključem. Vključen je opis OpenAPI 3.1.

Revised:

1. Kaj je to

REST API za WareRushAI omogoča drugim programom branje podatkov enega podjetja: izdelkov, zaloge po lokacijah, naročil, izdelkov z manjkajočimi podatki in napak pri objavi na tržnicah. V tej različici je na voljo samo za branje ter temelji na istih storitvah in preverjanjih dovoljenj kot spletna aplikacija in priključek MCP. Osnovni naslov je https://app.warerushai.com/api/v1. API se odpira postopoma: dokler ni vklopljen za platformo, vsak klic vrne kodo 404 in ključev ni mogoče ustvariti.

2. Ustvarite API-ključ

Lastnik ali skrbnik odpre Nastavitve, nato Integracije, nato API-ključi, poimenuje ključ, izbere dovoljenja (catalog.read, inventory.read, orders.read, account.read), veljavnost ter omejitev na minuto in ga ustvari. Celoten ključ se začne z wra_live_ in je prikazan samo enkrat. WareRushAI shrani le enosmerno zgoščeno vrednost (hash) in začetne znake, zato izgubljenega ključa ni mogoče obnoviti: ustvarite novega. Ključ lahko kadar koli prekličete ali zamenjate (rotate): novi ključ se prikaže enkrat, stari pa deluje še 24 ur.

3. Preverjanje pristnosti

Ključ pošljite v glavi Authorization: Authorization: Bearer wra_live_... prek HTTPS. Ključa nikoli ne vnašajte v spletni naslov; zahteva, ki to stori, je zavrnjena z napako key_in_url. Primer: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". Sprejeti so tudi dostopni žetoni OAuth 2.1 priključka MCP z dovoljenji, ki jih je uporabnik odobril.

4. Končne točke

GET /me (ključ, njegove omejitve in današnja poraba), GET /products (iskanje in seznam s parametri query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (postavke zaloge, oštevilčeno), GET /inventory/summary, GET /orders (s parametri updated_since, status, source, limit, cursor), GET /missing-data in GET /marketplace-errors (s parametrom channel). Vsaka končna točka potrebuje ustrezno dovoljenje: catalog.read za izdelke, manjkajoče podatke in napake na tržnicah, inventory.read za lokacije in zalogo, orders.read za naročila. Podprta je le metoda GET; druge metode vrnejo 405.

5. Paginacija in poizvedovanje (polling)

Seznami vrnejo data, next_cursor in has_more, z največ 50 elementi na stran (limit od 1 do 50, privzeto 20). Vrednost next_cursor posredujte nazaj kot cursor, da pridobite naslednjo stran. Za sprožilce poizvedovanja v orodjih Zapier, Make in n8n pokličite GET /orders?updated_since=2026-11-15T08:00:00Z in si zapomnite čas zadnjega uspešnega poizvedovanja: prejmete naročila, ustvarjena ali spremenjena od takrat, najnovejša najprej.

6. Omejitve in napake

Vsak ključ ima omejitev na minuto (privzeto 60, največ 600) in izbirno dnevno omejitev. Vsako podjetje ima tudi dnevno kvoto glede na paket: privzeto 1 000 klicev za Starter, 10 000 za Business in 100 000 za Pro. Ko je omejitev dosežena, API odgovori s kodo 429 in glavo Retry-After. Glave X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit in X-Daily-Remaining prikazujejo, koliko klicev je še na voljo. Napake so vedno v obliki {"error":{"code","message","request_id"}}; pri stiku s podporo navedite request_id. Pogoste kode: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited in daily_quota_exceeded (429).

7. Opis OpenAPI

Strojno berljiv opis OpenAPI 3.1 je na voljo na https://app.warerushai.com/api/v1/openapi.json in ne potrebuje ključa. Uvozite ga v Postman, Zapier, Make, n8n ali pomočnika AI, da pridobite vse končne točke, parametre in oblike odgovorov. Spremembe se uvajajo brez spreminjanja obstoječih polj; različica je /api/v1.

8. Varnost

Ključi pripadajo natanko enemu podjetju in se preverijo ob vsakem klicu; ključ nikoli ne more brati podatkov drugega podjetja in preneha delovati, če skrbnik, ki ga je ustvaril, zapusti podjetje. Ključi se nikoli ne pojavijo v dnevnikih ali sporočilih o napakah, dnevnik klicev pa prikazuje le pot, stanje in čas. Finančni podatki, kot so nabavne cene, prek tega API-ja niso izpostavljeni.