Preskoči na sadržaj
Preskoči na članak

API i integracije

Povežite program za skladište s Autobazom pomoću API ključa: tko to treba, kako izraditi ključ, koja prava postoje i kako ga čuvati.

2 min čitanja
Na ovoj stranici

API je za autootpade koji već vode zalihu u svom programu i ne žele ništa tipkati dvaput. Vaš program (ili njegov dobavljač) može čitati i slati dijelove i vozila izravno u Autobazu, a po želji i čitati narudžbe. Ako zalihu vodite u Excelu, dovoljan Vam je uvoz iz članka o uvozu i izvozu.

Kome treba

  • Imate program za skladište ili ERP i dobavljač može napraviti integraciju.
  • Zalihu mijenjate više puta dnevno (cijene, količine, prodani dijelovi).
  • Želite da se narudžbe automatski prenesu u Vaš sustav.

Kako izraditi ključ

  1. Otvorite „API i integracije”

    Postavke → „API i integracije”. Samo vlasnik upravlja ključevima, a u asistiranom načinu rada to nije moguće.

  2. „Novi API ključ”

    Upišite naziv (npr. „Program za skladište”), odaberite prava i potvrdite lozinkom.

  3. Kopirajte ključ

    Ključ vidite samo jednom. Kopirajte ga odmah i spremite na sigurno mjesto.

  4. Predajte ga dobavljaču

    Uz ključ priložite poveznicu na „Dokumentaciju API-ja”.

Prava ključa

PravoŠto dopušta
Čitanje dijelova i vozilaPregled Vaših dijelova i donorskih vozila.
Dodavanje, izmjena i brisanje dijelovaUpravljanje dijelovima po Vašoj šifri.
Dodavanje i izmjena vozilaUpravljanje donorskim vozilima.
Čitanje narudžbi s podacima kupacaImena, kontakt i adrese kupaca.

Upotreba i ograničenja

Ključ se šalje u zaglavlju Authorization: Bearer abk_…. Ograničenje je 120 zahtjeva u minuti po ključu. Dijelovi se identificiraju Vašom šifrom (external_id, 1 do 64 znaka), isto kao u uvozu, pa se isti komad ne duplicira. Novi dijelovi po zadanom nastaju kao skice. Možete imati najviše 5 aktivnih ključeva. Tehnička dokumentacija (na engleskom) je na /api-docs.

bash
curl -H "Authorization: Bearer abk_..." \
  "https://autobaza.hr/api/v1/parts?limit=20"

Sigurnost

  • Svaki sustav dobiva zaseban ključ pa ga možete opozvati bez prekida drugih.
  • Vidite „Zadnje korišten” za svaki ključ. Neiskorišten ključ opozovite.
  • „Opozovi” odmah gasi pristup svim programima koji taj ključ koriste.
  • Ključ nikad ne šaljite e-mailom ni ga ne spremajte u javne repozitorije.
Izgubio sam ključ.

Ne može se ponovno prikazati. Opozovite ga i izradite novi.

Može li moj radnik izraditi ključ?

Ne, samo vlasnik trgovine.

Može li API objaviti dio odmah?

Status možete postaviti na skicu, aktivno ili pauzirano. Aktivni oglasi traže povezan Stripe.

Dokumentacija API-jaPutanje, primjeri i opis svih polja (na engleskom).