API és integrációk

A platform API-first

Fejlesztő a kóddal teli képernyő előtt — programozott hozzáférés a digitális termékútlevelekhez.

Minden, amit a képernyő csinál, az API-n megy keresztül

A WIARA előbb épült API-ként, mint felületként. A vezérlőpult, amelyet használnak, ugyanazzal a programozott felülettel beszél, amelyet önök is megkapnak — nincs rejtett üzemmód és nincs olyan funkció, amely csak gombbal érhető el. Az integráció tehát nem kiegészítője a platformnak; maga a platform.

Két felület van. Az egyik az integrációé és az adminisztrációé — több mint száz művelet, OpenAPI 3.0.3 szerint dokumentálva: útlevelek, sablonok, szervezetek, fájlok, auditnyom, statisztikák. A másik nyilvános és csak olvasható, és ezen keresztül nyitja meg a világ magukat az útleveleket.

A teljes specifikációt elküldjük azoknak a csapatoknak, amelyek integrálnak — elég kérni. Nézzék meg a műszaki szabványokat is, amelyeken a platform áll, vagy magát a terméket

Mit automatizálhatnak

API és integrációk

Két felület, egy szerződés

Integrációs API a rendszereikhez és nyilvános, csak olvasható API magukhoz az útlevelekhez. Mindkettő OpenAPI 3.0.3 szerint dokumentálva.

GS1 Digital Link resolver

Az útlevelek GS1 Digital Link azonosság alapján nyílnak meg. A resolver megfelel az ISO/IEC 18975-nek — a szabványnak, nem saját sémának.

Modell, tétel, darab

Mind a három részletességi szint, plusz a termékváltozatok. Ugyanaz a QR-szabvány, bármelyik szintet nevezze is meg végül a felhatalmazáson alapuló jogi aktus.

Piszkozat, előnézet, közzététel

Az útlevél piszkozatként készül, védett hivatkozáson át ellenőrizhető, és akkor kerül közzétételre, amikor kész. Minden verzió megmarad az előzményekben.

Auditnyom kérésre

Ki mit módosított — objektum, felhasználó, gyártó, üzemeltető és platform szerint. Nem egyetlen hosszú napló, hanem kérdés válasszal.

24 nyelv, programozottan

Az útlevél értékei nyelvenként kezelhetők. Az automatikus fordítás útlevelenként külön kapcsolható be és ki.

Mit fed le a programozott hozzáférés

Az alábbi területek mindegyike teljes egészében az API-n keresztül vezérelhető, kézi lépés nélkül.

Az útlevél életciklusa

✅ Létrehozás, szerkesztés, piszkozat, előnézet védett hivatkozáson, közzététel és teljes verzióelőzmény.

Sablonok

✅ Sablonok készítése és verziózása, verziónkénti állapot, nyelvenkénti fordítások és egy adott gyártóhoz rendelt egyedi sablonok.

Szervezetek

✅ Platformok, üzemeltetők és gyártók a címeikkel és kapcsolattartóikkal — a tulajdonjog átruházásával együtt.

Üzemeltető ↔ gyártó összekapcsolás

✅ Meghívók kóddal, előnézet elfogadás előtt, elfogadás saját szervezet nevében és a kapcsolat bontása.

Fájlok és bizonyítékok

✅ Biztonságos feltöltés, fájlonkénti verzióelőzmény és aláírt, korlátozott ideig érvényes letöltési hivatkozások.

Auditnyom

✅ Lekérdezés objektum, végrehajtó és szervezet szerint — arra készült, hogy auditornak válaszoljon, nem arra, hogy görgessék.

Statisztikák

✅ Mutatók és idősorok hatókör szerint — az önök irányítópultjaihoz, nem csak a miénkhez.

Hozzáférés és tokenek

✅ Személyes hozzáférési tokenek felhasználónként kiadva és visszavonva, adminisztratív felügyelettel.

Taxonómia

✅ A rendeletek és termékcsoportok adatként tárolva — új termékcsoportot hozzáadni kell, nem újraépíteni.

Nyilvános olvasás

✅ Útlevél megnyitása GS1 Digital Link segítségével modell, tétel vagy darab szinten, a változatokkal együtt; a visszavont útlevél megkülönböztethetően válaszol, nem némán.

API és integrációk

Gyakori kérdések

Question Mark Section Supporting Image

Igen. A teljes OpenAPI specifikáció nincs szabadon közzétéve, de elküldjük minden csapatnak, amely integrációra készül — csak kérni kell. Így a dokumentáció azokhoz jut el, akik használják, és nem azokhoz, akik lemásolják.

Igen. A felület ugyanannak a programozott hozzáférésnek az ügyfele, amelyet önök is megkapnak. Ez a különbség egy API-val rendelkező platform és egy olyan platform között, amelyhez utólag tettek API-t.

Igen. Az útlevelek létrehozása és frissítése, a dokumentumok feltöltése és a szervezetek kezelése programozott műveletek, így a rendszerük közvetlenül hívhatja őket. Hogy melyik integrációs minta a megfelelő, az a rendszerüktől függ — ez a mérnökünkkel folytatott beszélgetés, nem kész recept.

GS1 Digital Linken keresztül — ez a szabványos mód, ahogyan egy QR-kód egy termékre mutat. A resolver megfelel az ISO/IEC 18975-nek, maga az azonosság pedig a GTIN-re épül.

A válasz megkülönböztethető. Egy útlevél, amelyet közzétettek és már nem érvényes, nem tesz úgy, mintha soha nem létezett volna — az olvasó rendszer látja a különbséget, és helyesen tud reagálni.

Még nem. Az EPCIS 2.0 tervezett bővítés az intenzív nyomonkövetést igénylő ágazatokhoz; az alap útlevél nem követeli meg. Inkább kimondjuk, mint hogy feltételezni engedjük.

Műszaki csapat munkamegbeszélésen — DPP-platform integrációja.
Nyílt SzabványokProgramozott Hozzáférés
Nyílt SzabványokProgramozott Hozzáférés
Utoljára ellenőrizve