API a integrácie

Platforma je API-first

Vývojár pri obrazovke s kódom — programový prístup k digitálnym pasom výrobku.

Všetko, čo robí obrazovka, ide cez API

WIARA bola postavená ako API skôr, než bola postavená ako rozhranie. Dashboard, ktorý používate, hovorí s tým istým programovým rozhraním, aké dostanete aj vy — nie je tu skrytý režim ani funkcia dostupná len tlačidlom. Integrácia teda nie je doplnkom platformy; je to samotná platforma.

Rozhrania sú dve. Jedno slúži na integráciu a správu — vyše sto operácií zdokumentovaných podľa OpenAPI 3.0.3: pasy, šablóny, organizácie, súbory, auditná stopa, štatistiky. Druhé je verejné a len na čítanie a práve ním svet otvára samotné pasy.

Úplnú špecifikáciu posielame tímom, ktoré integrujú — stačí si o ňu napísať. Pozrite si aj technické normy, na ktorých platforma stojí, alebo samotný produkt

Čo môžete automatizovať

API a integrácie

Dve rozhrania, jedna zmluva

Integračné API pre vaše systémy a verejné API len na čítanie pre samotné pasy. Obe zdokumentované podľa OpenAPI 3.0.3.

GS1 Digital Link resolver

Pasy sa otvárajú podľa identity GS1 Digital Link. Resolver zodpovedá ISO/IEC 18975 — norme, nie vlastnej schéme.

Model, šarža, kus

Všetky tri úrovne granularity plus varianty výrobku. Rovnaký QR štandard bez ohľadu na to, ktorú úroveň napokon určí váš delegovaný akt.

Koncept, náhľad, publikovanie

Pas sa pripraví ako koncept, skontroluje cez chránený odkaz a publikuje, keď je hotový. Každá verzia zostáva v histórii.

Auditná stopa na požiadanie

Kto čo zmenil — podľa objektu, používateľa, výrobcu, operátora, platformy. Nie jeden dlhý žurnál, ale otázka s odpoveďou.

24 jazykov programovo

Hodnoty pasu sa spravujú po jazykoch. Automatický preklad sa zapína a vypína pre každý pas osobitne.

Čo pokrýva programový prístup

Každú z týchto oblastí možno riadiť úplne cez API, bez ručného kroku v rozhraní.

Životný cyklus pasu

✅ Vytvorenie, úprava, koncept, náhľad cez chránený odkaz, publikovanie a plná história verzií.

Šablóny

✅ Tvorba a verziovanie šablón, stav každej verzie, preklady po jazykoch a šablóny na mieru priradené konkrétnemu výrobcovi.

Organizácie

✅ Platformy, operátori a výrobcovia s adresami a kontaktmi — vrátane prevodu vlastníctva.

Prepojenie operátor ↔ výrobca

✅ Pozvánky s kódom, náhľad pred prijatím, prijatie v mene vlastnej organizácie a zrušenie väzby.

Súbory a doklady

✅ Zabezpečené nahrávanie, história verzií pri každom súbore a podpísané odkazy na stiahnutie s obmedzenou platnosťou.

Auditná stopa

✅ Dopyty podľa objektu, aktéra a organizácie — určené na odpoveď audítorovi, nie na listovanie žurnálom.

Štatistiky

✅ Ukazovatele a časové rady podľa rozsahu — pre vaše dashboardy, nielen pre náš.

Prístup a tokeny

✅ Osobné prístupové tokeny vydávané a odoberané podľa používateľa, s administratívnym dohľadom.

Taxonómia

✅ Predpisy a skupiny výrobkov ako dáta — nová skupina výrobkov sa pridá, nerobí sa nanovo.

Verejné čítanie

✅ Otvorenie pasu cez GS1 Digital Link na úrovni modelu, šarže alebo kusu, vrátane variantov; stiahnutý pas odpovedá rozlíšiteľne, nie mlčky.

API a integrácie

Časté otázky

Áno. Úplná špecifikácia OpenAPI nie je voľne publikovaná, ale posielame ju každému tímu, ktorý pripravuje integráciu — stačí si povedať. Dokumentácia sa tak dostane k ľuďom, ktorí ju používajú, a nie k tým, čo ju kopírujú.

Áno. Rozhranie je klientom toho istého programového prístupu, aký dostanete vy. To je rozdiel medzi platformou s API a platformou, ku ktorej bolo API dodatočne pridané.

Áno. Vytváranie a aktualizácia pasov, nahrávanie dokumentov aj správa organizácií sú programové operácie, takže ich váš systém môže volať priamo. Ktorý integračný vzor je ten správny, závisí od vášho systému — to je rozhovor s naším inžinierom, nie hotový recept.

Cez GS1 Digital Link — štandardný spôsob, akým QR kód ukazuje na výrobok. Resolver zodpovedá ISO/IEC 18975 a samotná identita stavia na GTIN.

Odpoveď je rozlíšiteľná. Pas, ktorý bol publikovaný a už neplatí, sa netvári, že nikdy neexistoval — systém, ktorý ho číta, rozdiel spozná a môže zareagovať správne.

Zatiaľ nie. EPCIS 2.0 je plánované rozšírenie pre odvetvia s intenzívnou sledovateľnosťou; základný pas ho nevyžaduje. Radšej to povieme, než aby sa to predpokladalo.

Technický tím na pracovnom stretnutí — integrácia platformy DPP.
Otvorené ŠtandardyProgramový Prístup
Otvorené ŠtandardyProgramový Prístup
Naposledy overené