REST API povezuje vaš poslovni sistem (ERP, spletno trgovino) s portalom GumTrade: cene in zaloga po EAN ali ID za vaše podjetje, košarica in naročila ter neposredno naročilo brez košarice. Spodaj je celotna referenca, ki je ustvarjena iz istih pogodb kot portal.
Avtentikacija
Vsako zahtevo podpišite z API ključem v glavi Authorization. Ključ ima pravice uporabnika, ki ga je ustvaril (cene z rabatom podjetja, naročila podjetja); prikazan je samo enkrat in ga lahko kadar koli prekličete.
Na ključ je dovoljenih 300 zahtev na minuto. Nad mejo dobite 429 rate_limited z glavo Retry-After (sekunde do nove minute). Ponavljanje z neveljavnimi ključi z istega naslova prav tako vrne 429.
Zneski in količine
Zneski so cela števila v centih brez DDV (unitNetCents), razen kjer ime pove drugače (grossCents z DDV). Odstotki so v bazičnih točkah: 2200 bp je 22 %.
Naročanje
Neposredno naročilo gre v dveh korakih: najprej POST /api/v1/account/direct-orders/quote za ponudbo z vrsticami po EAN ali ID, nato POST /api/v1/account/direct-orders z istimi vrsticami, poljem seen iz ponudbe in naključnim idempotencyKey (UUID). Če se je cena vmes spremenila, dobite spremembe in svežo ponudbo; nič ni oddano. Isti idempotencyKey vedno vrne isto naročilo, zato zahtevo po izgubljenem odgovoru varno ponovite.
Varnost
Ključ uporabljajte samo na strežniku, nikoli v brskalniku ali mobilni aplikaciji. API ne pošilja glav CORS. Ključi, povabila in skrbništvo podjetja se upravljajo samo v prijavljenem brskalniku, zato ukradeni ključ ne more ustvariti novega dostopa.
MCP za asistente AI
Asistent AI (Claude Code ali drug odjemalec MCP) lahko prek strežnika MCP išče gume, preveri cene in zalogo za vaše podjetje, napolni košarico in odda naročilo. Strežnik uporablja iste pravice in pravila kot portal in REST API.
Povezava potrebuje API ključ v glavi Authorization. Asistent pred vsakim orodjem, ki kaj spremeni, vpraša za potrditev; naročilo odda šele, ko se znesek ujema z zadnjim pregledom košarice.
Strežnik stranke
Za ključ uporabnika odobrenega podjetja: cene z vašim rabatom, košarica, oddaja in pregled naročil vašega podjetja. Ključ ustvarite v Mojem računu.
Naslov strežnika
https://test.gumtrade.si/api/mcp/stranka
Povezava v Claude Code (ključ vstavite namesto gtk_…)
Povezava s konektorji Claude Desktop (prijava OAuth) bo na voljo kasneje. Do takrat uporabite odjemalca, ki pošlje glavo Authorization, na primer Claude Code.