Resursi

Javni REST API za WareRushAI (samo za čitanje)

Čitajte svoje proizvode, zalihe, narudžbe, nedostajuće podatke i pogreške s marketplacea iz alata Zapier, Make, n8n ili vlastitog koda pomoću API ključa. Uključen je OpenAPI 3.1 opis.

Revised:

1. Što je to

REST API za WareRushAI omogućuje drugim programima čitanje podataka jedne tvrtke: proizvoda, zaliha po lokacijama, narudžbi, proizvoda s nedostajućim podacima i pogrešaka pri objavi na marketplaceima. U ovoj verziji služi samo za čitanje i oslanja se na iste servise i provjere ovlasti kao i web-aplikacija te MCP konektor. Bazna adresa je https://app.warerushai.com/api/v1. API se otvara postupno: dok se ne uključi za platformu, svaki poziv vraća 404 i nije moguće stvarati ključeve.

2. Stvaranje API ključa

Vlasnik ili administrator otvara Postavke, zatim Integracije, pa API ključevi, imenuje ključ, odabire ovlasti (catalog.read, inventory.read, orders.read, account.read), rok valjanosti i ograničenje po minuti te ga stvara. Puni ključ počinje s wra_live_ i prikazuje se samo jednom. WareRushAI pohranjuje samo jednosmjerni hash i početne znakove, pa se izgubljeni ključ ne može oporaviti: stvorite novi. Ključ možete opozvati u bilo kojem trenutku ili ga rotirati: novi se ključ prikazuje jednom, a stari nastavlja raditi 24 sata.

3. Autentifikacija

Pošaljite ključ u zaglavlju Authorization: Authorization: Bearer wra_live_... putem HTTPS-a. Nikada ne stavljajte ključ u web-adresu; zahtjev koji to učini bit će odbijen uz pogrešku key_in_url. Primjer: curl -H "Authorization: Bearer $WRA_KEY" "https://app.warerushai.com/api/v1/products?limit=20". Prihvaćaju se i pristupni tokeni za OAuth 2.1 iz MCP konektora, uz ovlasti koje je korisnik odobrio.

4. Krajnje točke

GET /me (ključ, njegova ograničenja i današnja potrošnja), GET /products (pretraživanje i popis, uz query, limit, cursor), GET /products/{id}, GET /locations, GET /inventory (stavke zaliha, s paginacijom), GET /inventory/summary, GET /orders (uz updated_since, status, source, limit, cursor), GET /missing-data i GET /marketplace-errors (uz channel). Svaka krajnja točka zahtijeva odgovarajuću ovlast: catalog.read za proizvode, nedostajuće podatke i pogreške s marketplacea, inventory.read za lokacije i zalihe, orders.read za narudžbe. Podržan je samo GET; ostale metode vraćaju 405.

5. Paginacija i periodičko dohvaćanje (polling)

Popisi vraćaju data, next_cursor i has_more, s najviše 50 stavki po stranici (limit od 1 do 50, zadano 20). Proslijedite next_cursor natrag kao cursor kako biste dohvatili sljedeću stranicu. Za okidače periodičkog dohvaćanja u alatima Zapier, Make i n8n pozovite GET /orders?updated_since=2026-11-15T08:00:00Z i zabilježite vrijeme posljednjeg uspješnog dohvaćanja: dobit ćete narudžbe stvorene ili izmijenjene od tada, počevši od najnovijih.

6. Ograničenja i pogreške

Svaki ključ ima ograničenje po minuti (zadano 60, najviše 600) i neobavezno dnevno ograničenje. Svaka tvrtka također ima dnevnu kvotu prema tarifi: zadano 1 000 poziva za Starter, 10 000 za Business i 100 000 za Pro. Kada se dosegne ograničenje, API odgovara sa statusom 429 uz zaglavlje Retry-After. Zaglavlja X-RateLimit-Limit, X-RateLimit-Remaining, X-Daily-Limit i X-Daily-Remaining prikazuju preostalu kvotu. Pogreške uvijek imaju oblik {"error":{"code","message","request_id"}}; navedite request_id kada se obraćate podršci. Uobičajeni kodovi: invalid_api_key (401), insufficient_scope (403), not_found (404), invalid_parameter (400), rate_limited i daily_quota_exceeded (429).

7. OpenAPI opis

Strojno čitljiv OpenAPI 3.1 opis nalazi se na https://app.warerushai.com/api/v1/openapi.json i ne zahtijeva ključ. Uvezite ga u Postman, Zapier, Make, n8n ili AI asistenta kako biste dobili sve krajnje točke, parametre i oblike odgovora. Promjene se uvode bez narušavanja postojećih polja; verzija je /api/v1.

8. Sigurnost

Ključevi pripadaju točno jednoj tvrtki i provjeravaju se pri svakom pozivu; ključ nikada ne može čitati podatke druge tvrtke i prestaje raditi ako administrator koji ga je stvorio napusti tvrtku. Ključevi se nikada ne pojavljuju u zapisnicima ili porukama o pogrešci, a zapisnik poziva prikazuje samo putanju, status i vrijeme. Financijski podaci, poput nabavnih cijena, nisu izloženi putem ovog API-ja.