Pristup
Ključ
Ključ izdaje wagen, posebno za svakog partnera. Pišite na kontakt@wagen.hr tko ste, koji API vas zanima i za što ćete ga koristiti.
Ključ počinje s wgn_ i šalje se u zaglavlju svakog poziva:
curl -H "Authorization: Bearer wgn_…" https://api.wagen.hr/cijene/v1/vozilaKljuč vidimo samo u trenutku izdavanja; kod nas se čuva samo njegov otisak. Ako ga izgubite ili mislite da ga zna netko drugi, javite se: stari gasimo i izdajemo novi.
Suglasnost salona
DMS oglasi, Upiti kupaca, Studio fotografije, Statistika oglasa i Zaliha salona rade s podacima pojedinog salona. Salon vaš sustav povezuje u svom Kokpitu na wagenu i može ga odspojiti kad želi. Dok veza ne postoji, ključ ne vidi i ne mijenja ništa od tog salona.
Osobni podaci
Cijene vozila ne sadrže osobne podatke: nema VIN-a, registracije, prodavača ni kontakta. Upiti kupaca sadrže kontakt kupca jer ga je kupac poslao salonu; partner ga smije koristiti samo za odgovor tom salonu.
Dobra praksa
- Preuzimajte samo promjene od zadnjeg poziva (parametar od), a ne sve iznova.
- Najviše 500 zapisa po stranici; sljedeću stranicu tražite s vrijednošću sljedeca_stranica.
- Odgovori su JSON u UTF-8, vremena u ISO 8601 (UTC), cijene u eurima kao cijeli brojevi.
- Greške vraćaju HTTP status i polje greska s opisom na hrvatskom.