API Dokumentáció kezdőlap
Általános információk:
Az API URL címe: https://api.ilogistic.eu/
Az API rendelkezik egy staging szerverrel is ami a következő címen érhető el: https://devapi.ilogistic.eu/ A developer/sandbox felületre az alábbi grafikus felületen szükséges regisztrálni: https://dev.ilogistic.eu
A használathoz szükséges egy már beaktivált fiók az iLogistic Raktárkezelő oldalán,
felhasználóját regisztráció után és az Első lépések
menüpont kitöltését követően egy admin felhasználó fogja
beaktiválni.
Amennyiben egy munkatársa vagy felettese rendelkezik regisztrált céggel az iLogistic felületén, a regisztrációt
követően, munkatársa meg tudja hívni a cégébe a Felhasználók
menüpont alatt.
Az API RESTful alapú, tehát úgynevezett "stateless" (állapot nélküli).
A kommunikáció módja HTTP(s) kérésekkel zajlik, az információ cseréjének módját/személyét kérésenként határozzuk meg és módosítjuk.
Az üzenetek formája lehet:
application/json
application/x-www-form-urlencoded
Az üzenet átadás HTTP 1.1 protokol alatt történik a következő metódusokkal:
POST
GET
PATCH
DELETE
Az autentikáció az Authorization
header-el történik, Bearer
token segítségével.
Az API-n keresztül az alábbi rate limit található: 100 kérés / másodperc
Példa:
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJhcGkuaWxvZ2lzdGljLmV1IiwiYXVkIjoiYXBpLmlsb2dpc3RpYy5ldSIsImlhdCI6MTU5NTU5NjE3NywianRpIjoiNGJkZmEzNDAiLCJlbWFpbCI6ImFzZEBsb2NhbGhvc3QuaW8iLCJwZXJtaXNzaW9uIjoiOCJ9.w33bjQUnSTWSmKll9n2YmsYuGdkiVVBAdNVhQP9r_Q3AQICAgDYyq_KZGDgKkJhMexJcMAjcsK5OTzALZxeo3A
A token 604800 másodpercig (7 napig) érvényes, ezt követi egy 120 másodperces (2 perc) úgynevezett leeway
, ami
lehetőséget ad a token lejárta után egy új kiállítására.
A rendszer minden átadott rendeléshez rögzített rendelési értékről alapértelmezetten feltételezi, hogy a webáruházban rögzített és/vagy átadott érték az adott ország hivatalosan elfogadott devizanemében került rögzítésre. A rendszer devizanemek közötti átváltást nem végez, így az utánvétes rendelések esetén az adott rendeléshez rögzített értéket változatlanul adja tovább a futárcégeknek a rendelés kiszállítása során beszedendő utánvét összegként.