API i integracije

Platforma je izgrađena API-first

Programer ispred zaslona s kodom — programski pristup digitalnim putovnicama proizvoda.

Sve što radi zaslon prolazi kroz API

WIARA je najprije izgrađena kao API, a tek onda kao sučelje. Nadzorna ploča kojom se služite razgovara s istim programskim sučeljem koje dobivate vi — nema skrivenog načina rada ni funkcije koja postoji samo iza gumba. Integracija zato nije dodatak platformi; ona je platforma.

Postoje dva sučelja. Jedno je za integraciju i administraciju — više od stotinu operacija dokumentiranih prema OpenAPI 3.0.3: putovnice, predlošci, organizacije, datoteke, revizijski trag, statistika. Drugo je javno i samo za čitanje, i preko njega svijet otvara same putovnice.

Punu specifikaciju šaljemo timovima koji rade integraciju — zatražite je i dobit ćete je. Možda vas zanimaju i tehničke norme na kojima je platforma izgrađena ili sam proizvod →

Što možete automatizirati

API i integracije

Dva sučelja, jedan ugovor

Integracijski API za vaše sustave i javni API samo za čitanje za same putovnice. Oba su dokumentirana prema OpenAPI 3.0.3.

Resolver GS1 Digital Link

Putovnice se otvaraju prema identitetu GS1 Digital Link. Resolver je usklađen s normom ISO/IEC 18975 — riječ je o normi, a ne o vlasničkoj shemi.

Model, serija, pojedinačni proizvod

Sve tri razine granularnosti i varijante proizvoda. Isti QR standard, koju god razinu vaš delegirani akt na kraju propiše.

Nacrt, pregled, objava

Putovnica se priprema kao nacrt, pregledava putem zaštićene poveznice i objavljuje kad je spremna. Svaka verzija ostaje u povijesti.

Revizijski trag na zahtjev

Tko je što promijenio — po objektu, korisniku, proizvođaču, operateru ili platformi. Ne jedan dugi dnevnik, nego pitanje na koje postoji odgovor.

24 jezika, programski

Vrijednosti u putovnici vode se po jezicima. Automatski prijevod uključuje se ili isključuje za svaku putovnicu.

Što obuhvaća programski pristup

Svakim od ovih područja upravlja se u potpunosti putem API-ja, bez ručnog koraka u sučelju.

Životni ciklus putovnice

✅ Izrada, uređivanje, nacrt, pregled putem zaštićene poveznice, objava i potpuna povijest verzija.

Predlošci

✅ Izrada i verzioniranje predložaka, status po verziji, prijevodi po jezicima i predlošci po mjeri dodijeljeni jednom proizvođaču.

Organizacije

✅ Platforme, operateri i proizvođači s adresama i kontaktima — uključujući prijenos vlasništva.

Povezivanje operatera i proizvođača

✅ Pozivni kodovi, pregled prije prihvaćanja, prihvaćanje u ime vlastite organizacije i razdvajanje.

Datoteke i dokazi

✅ Sigurno učitavanje, povijest verzija za svaku datoteku i potpisane poveznice za preuzimanje s ograničenim rokom valjanosti.

Revizijski trag

✅ Upiti po objektu, po izvršitelju i po organizaciji — napravljeni da odgovore revizoru, a ne da se kroz njih lista.

Statistika

✅ Metrike i vremenski nizovi po opsegu — za vaše nadzorne ploče, ne samo za naše.

Pristup i tokeni

✅ Osobni pristupni tokeni koji se izdaju i opozivaju po korisniku, uz administratorski nadzor.

Taksonomija

✅ Propisi i skupine proizvoda vode se kao podaci — nova skupina proizvoda se dodaje, a ne razvija ispočetka.

Javno čitanje

✅ Otvaranje putovnice putem GS1 Digital Linka na razini modela, serije ili pojedinačnog proizvoda, uključujući varijante; povučena putovnica daje prepoznatljiv odgovor umjesto da šuti.

API i integracije

Česta pitanja

Da. Puna specifikacija OpenAPI nije javno objavljena, ali je šaljemo svakom timu koji priprema integraciju — dovoljno je zatražiti. Tako dokumentacija stiže do ljudi koji je koriste, a ne do onih koji je kopiraju.

Da. Sučelje je klijent istog programskog pristupa koji dobivate vi. To je razlika između platforme s API-jem i platforme kojoj je API naknadno dodan.

Da. Izrada i ažuriranje putovnica, učitavanje dokumenata i upravljanje organizacijama programske su operacije, pa ih vaš sustav može pozivati izravno. Koji je obrazac integracije pravi ovisi o vašem sustavu — o tome razgovarate s našim inženjerom, nema gotovog recepta.

Putem GS1 Digital Linka — standardnog načina na koji QR kod upućuje na proizvod. Resolver je usklađen s normom ISO/IEC 18975, a sam identitet temelji se na GTIN-u.

Odgovor je prepoznatljiv. Putovnica koja je bila objavljena, a više ne vrijedi, ne prikazuje se kao da nikada nije postojala — sustav koji je čita može uočiti razliku i postupiti u skladu s time.

Još ne. EPCIS 2.0 planirano je proširenje za sektore s intenzivnom sljedivošću; osnovna putovnica ga ne zahtijeva. Radije to kažemo otvoreno nego da se pretpostavlja.

Tehnički tim na radnom sastanku — integracija platforme za DPP.
Otvorene normeProgramski pristup
Otvorene normeProgramski pristup
Posljednja provjera

DigitalProductPassport u drugim zemljama: Albanija · Bugarska · Češka · Grčka · Mađarska · Poljska · Rumunjska · Slovačka · Srbija · Europska unija