Skoči na vsebino
GumTrade, začetna stran

Za razvijalce

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.

Authorization: Bearer gtk_…Ključ ustvarite v Mojem računu

Napake

Napaka vrne ustrezno kodo HTTP in telo s stabilno kodo napake ter sporočilom. Neveljaven, potekel ali preklican ključ vrne 401 invalid_api_key.

{ "error": { "code": "invalid_api_key", "message": "…" } }

Omejitve

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_…)

claude mcp add --transport http gumtrade-stranka https://test.gumtrade.si/api/mcp/stranka --header "Authorization: Bearer gtk_…"

Branje

  • search_tyresIskanje gum
  • get_productPodrobnosti gume
  • lookup_productsCene po EAN ali ID
  • quote_priceCena za količino
  • list_addressesNaslovi podjetja
  • list_ordersNaročila podjetja
  • get_orderPodrobnosti naročila
  • get_cartKošarica

Spremembe

  • add_to_cartDodaj v košarico
  • set_cart_quantitySpremeni količino
  • remove_from_cartOdstrani iz košarice
  • place_orderOddaj naročilo

Povezava s konektorji Claude Desktop (prijava OAuth) bo na voljo kasneje. Do takrat uporabite odjemalca, ki pošlje glavo Authorization, na primer Claude Code.

Referenca API