API in integracije

Platforma je zgrajena po načelu API-first

Razvijalec pred zaslonom s kodo – programski dostop do digitalnih potnih listov izdelkov.

Vse, kar naredi zaslon, gre skozi API

WIARA je bila najprej zgrajena kot API in šele nato kot vmesnik. Nadzorna plošča, ki jo uporabljate, komunicira z istim programskim vmesnikom, ki ga dobite vi – ni skritega načina delovanja ne funkcije, ki bi obstajala samo za gumbom. Integracija zato ni dodatek k platformi; integracija je platforma.

Vmesnika sta dva. Prvi je za integracijo in upravljanje – več kot sto operacij, dokumentiranih po OpenAPI 3.0.3: potni listi, predloge, organizacije, datoteke, revizijska sled, statistika. Drugi je javen in samo za branje; prek njega potne liste odpira kdor koli.

Celotno specifikacijo pošljemo ekipam, ki delajo integracijo – zaprosite zanjo in jo boste dobili. Morda vas zanimajo tudi tehnični standardi, na katerih je zgrajena platforma, ali sam produkt →

Kaj lahko avtomatizirate

API in integracije

Dva vmesnika, ena specifikacija

Integracijski API za vaše sisteme in javni API samo za branje za same potne liste. Oba sta dokumentirana po OpenAPI 3.0.3.

Razreševalnik GS1 Digital Link

Potni listi se odpirajo po identiteti GS1 Digital Link. Razreševalnik je skladen s standardom ISO/IEC 18975 – gre za standard, ne za lastniško shemo.

Model, serija, posamezen izdelek

Vse tri ravni podrobnosti in različice izdelkov. Isti standard QR, ne glede na to, katero raven bo na koncu predpisal vaš delegirani akt.

Osnutek, pregled, objava

Potni list se pripravi kot osnutek, pregleda prek zaščitene povezave in objavi, ko je pripravljen. Vsaka različica ostane v zgodovini.

Revizijska sled na zahtevo

Kdo je kaj spremenil – po objektu, uporabniku, proizvajalcu, operaterju ali platformi. Ne dolg dnevnik, ki ga je treba prebrati, ampak vprašanje, na katero dobite odgovor.

24 jezikov, programsko

Vrednosti v potnem listu se vodijo po jezikih. Samodejni prevod vklopite ali izklopite za vsak potni list posebej.

Kaj zajema programski dostop

Vsako od teh področij v celoti upravljate prek vmesnika API, brez ročnega koraka v vmesniku.

Življenjski cikel potnega lista

✅ Izdelava, urejanje, osnutek, pregled prek zaščitene povezave, objava in celotna zgodovina različic.

Predloge

✅ Izdelava predlog in upravljanje njihovih različic, status po različici, prevodi po jezikih in predloge po meri, dodeljene enemu proizvajalcu.

Organizacije

✅ Platforme, operaterji in proizvajalci z naslovi in kontakti – vključno s prenosom lastništva.

Povezovanje operaterjev in proizvajalcev

✅ Kode za povabilo, pregled pred sprejetjem, sprejetje v imenu lastne organizacije in prekinitev povezave.

Datoteke in dokazila

✅ Varno nalaganje, zgodovina različic za vsako datoteko in podpisane povezave za prenos z omejeno veljavnostjo.

Revizijska sled

✅ Poizvedbe po objektu, izvajalcu in organizaciji – narejene zato, da odgovorijo revizorju, ne zato, da bi jih listali.

Statistika

✅ Metrike in časovne vrste po obsegu – za vaše nadzorne plošče, ne samo za naše.

Dostop in žetoni

✅ Osebni dostopni žetoni, ki se izdajajo in prekličejo po uporabniku, pod nadzorom skrbnika.

Taksonomija

✅ Predpisi in skupine izdelkov se vodijo kot podatki – novo skupino izdelkov dodamo, ne razvijamo je od začetka.

Javno branje

✅ Odpiranje potnega lista prek GS1 Digital Link na ravni modela, serije ali posameznega izdelka, vključno z različicami; umaknjen potni list vrne prepoznaven odgovor, namesto da molči.

API in integracije

Pogosta vprašanja

Da. Celotna specifikacija OpenAPI ni javno objavljena, pošljemo pa jo vsaki ekipi, ki pripravlja integracijo – dovolj je, da zanjo zaprosite. Tako dokumentacija pride do ljudi, ki jo uporabljajo, in ne do tistih, ki jo kopirajo.

Da. Nadzorna plošča je odjemalec istega programskega dostopa, ki ga dobite vi. To je razlika med platformo z vmesnikom API in platformo, ki so ji API dodali naknadno.

Da. Izdelava in posodabljanje potnih listov, nalaganje dokumentov in upravljanje organizacij so programske operacije, zato jih vaš sistem lahko kliče neposredno. Kateri vzorec integracije je pravi, je odvisno od vašega sistema – o tem se pogovorite z našim inženirjem, pripravljenega recepta ni.

Prek GS1 Digital Link – standardnega načina, kako koda QR kaže na izdelek. Razreševalnik je skladen s standardom ISO/IEC 18975, sama identiteta pa temelji na GTIN.

Odgovor je prepoznaven. Potni list, ki je bil objavljen in ne velja več, se ne prikaže, kot da ga nikoli ni bilo – sistem, ki ga bere, lahko razliko opazi in ustrezno ukrepa.

Še ne. EPCIS 2.0 je načrtovana razširitev za sektorje, kjer je sledljivost zahtevnejša; osnovni potni list ga ne potrebuje. Raje to povemo odkrito, kot da bi kdo to domneval.

Tehnična ekipa na delovnem sestanku – integracija platforme za DPP.
Odprti standardiProgramski dostop
Odprti standardiProgramski dostop
Nazadnje preverjeno

DigitalProductPassport v drugih državah: Albanija · Bolgarija · Češka · Grčija · Hrvaška · Madžarska · Poljska · Romunija · Slovaška · Srbija · Evropska unija