API i integracije

Platforma je API-first

Programer ispred ekrana sa kodom – programski pristup digitalnim pasošima proizvoda.

Sve što radi ekran ide preko API-ja

WIARA je izgrađena kao API pre nego što je dobila korisnički interfejs. Kontrolna tabla koju koristite komunicira sa istim programskim interfejsom koji dobijate i vi – nema privatnog režima niti funkcije koja postoji samo iza nekog dugmeta. Integracija zato nije dodatak platformi; integracija je sama platforma.

Postoje dva interfejsa. Jedan služi za integraciju i administraciju – više od sto operacija dokumentovanih po OpenAPI 3.0.3: pasoši, šabloni, organizacije, fajlovi, revizijski trag, statistika. Drugi je javan i samo za čitanje, i preko njega svet otvara same pasoše.

Kompletnu specifikaciju šaljemo timovima koji rade integraciju – samo je zatražite. Možda vas zanimaju i tehnički standardi na kojima je platforma izgrađena, ili sam proizvod →

Šta možete da automatizujete

API i integracije

Dva interfejsa, jedan ugovor

API za integraciju sa vašim sistemima i javni API samo za čitanje za same pasoše. Oba su dokumentovana po OpenAPI 3.0.3.

GS1 Digital Link resolver

Pasoši se otvaraju preko GS1 Digital Link identiteta. Resolver je usklađen sa ISO/IEC 18975 – standardom, a ne zatvorenom šemom jednog dobavljača.

Model, serija, primerak

Sva tri nivoa granularnosti, plus varijante proizvoda. Isti QR standard, koji god nivo vaš delegirani akt na kraju propiše.

Nacrt, pregled, objava

Pasoš se priprema kao nacrt, pregleda preko zaštićenog linka i objavljuje kada je spreman. Svaka verzija ostaje u istoriji.

Revizijski trag na zahtev

Ko je šta promenio – po objektu, korisniku, proizvođaču, operateru, platformi. Ne jedan dugačak dnevnik, već pitanje koje ima odgovor.

24 jezika, programski

Vrednostima u pasošu upravlja se po jeziku. Automatski prevod se uključuje ili isključuje za svaki pasoš posebno.

Šta obuhvata programski pristup

Svakom oblašću ispod upravlja se u potpunosti preko API-ja, bez ijednog ručnog koraka u interfejsu.

Životni ciklus pasoša

✅ Kreiranje, izmena, nacrt, pregled preko zaštićenog linka, objava i kompletna istorija verzija.

Šabloni

✅ Kreiranje šablona i verzionisanje, status po verziji, prevodi po jeziku i namenski šabloni dodeljeni jednom proizvođaču.

Organizacije

✅ Platforme, operateri i proizvođači sa adresama i kontaktima – uključujući prenos vlasništva.

Povezivanje operater ↔ proizvođač

✅ Pozivni kodovi, pregled pre prihvatanja, prihvatanje u ime sopstvene organizacije i raskidanje veze.

Fajlovi i dokazi

✅ Bezbedno otpremanje, istorija verzija za svaki fajl i potpisani linkovi za preuzimanje sa ograničenim rokom važenja.

Revizijski trag

✅ Upiti po objektu, po akteru i po organizaciji – napravljeni da odgovore revizoru, a ne da se listaju.

Statistika

✅ Metrike i vremenske serije po obuhvatu – za vaše kontrolne table, ne samo za naše.

Pristup i tokeni

✅ Lični pristupni tokeni koji se izdaju i opozivaju po korisniku, uz administrativni nadzor.

Taksonomija

✅ Propisi i grupe proizvoda čuvaju se kao podaci – nova grupa proizvoda se dodaje, a ne razvija ispočetka.

Javno čitanje

✅ Otvaranje pasoša preko GS1 Digital Link na nivou modela, serije ili primerka, uključujući varijante; povučen pasoš daje prepoznatljiv odgovor umesto da prosto nestane.

API i integracije

Česta pitanja

Da. Kompletna OpenAPI specifikacija nije javno objavljena, ali je šaljemo svakom timu koji priprema integraciju – dovoljno je da je zatražite. Tako dokumentacija stiže do onih koji je koriste, a ne do onih koji je kopiraju.

Da. Interfejs je klijent istog programskog pristupa koji dobijate i vi. To je razlika između platforme sa API-jem i platforme kojoj je API naknadno dodat.

Da. Kreiranje i ažuriranje pasoša, otpremanje dokumenata i upravljanje organizacijama su programske operacije, pa vaš sistem može direktno da ih poziva. Koji je obrazac integracije pravi zavisi od vašeg sistema – to je razgovor sa nekim od naših inženjera, a ne gotov recept.

Preko GS1 Digital Link – standardnog načina da QR kod upućuje na proizvod. Resolver je usklađen sa ISO/IEC 18975, a sam identitet počiva na GTIN-u.

Odgovor je prepoznatljiv. Pasoš koji je bio objavljen, a više ne važi, ne prikazuje se kao da nikada nije postojao – sistem koji ga čita vidi razliku i može da postupi u skladu s tim.

Još ne. EPCIS 2.0 je planirano proširenje za sektore sa intenzivnom sledljivošću; osnovni pasoš ga ne zahteva. Radije to kažemo otvoreno nego da se podrazumeva.

Tehnički tim na radnom sastanku – integracija DPP platforme.
Otvoreni standardiProgramski pristup
Otvoreni standardiProgramski pristup
Poslednja provera

DigitalProductPassport u drugim zemljama: Albanija · Bugarska · Češka · Grčka · Hrvatska · Mađarska · Poljska · Rumunija · Slovačka · Evropska unija