API a integrace

Platforma je API-first

Vývojář u obrazovky s kódem — programový přístup k digitálním pasům výrobku.

Všechno, co dělá obrazovka, jde přes API

WIARA byla postavena jako API dříve, než byla postavena jako rozhraní. Dashboard, který používáte, mluví se stejným programovým rozhraním, jaké dostanete i vy — není zde skrytý režim ani funkce dostupná pouze tlačítkem. Integrace tedy není doplňkem platformy; je to samotná platforma.

Rozhraní jsou dvě. Jedno slouží k integraci a správě — přes sto operací dokumentovaných podle OpenAPI 3.0.3: pasy, šablony, organizace, soubory, auditní stopa, statistiky. Druhé je veřejné a pouze pro čtení a právě jím svět otevírá samotné pasy.

Úplnou specifikaci posíláme týmům, které integrují — stačí si o ni napsat. Podívejte se také na technické normy, na kterých platforma stojí, nebo na samotný produkt

Co můžete automatizovat

API a integrace

Dvě rozhraní, jedna smlouva

Integrační API pro vaše systémy a veřejné API pouze pro čtení pro samotné pasy. Obojí dokumentováno podle OpenAPI 3.0.3.

GS1 Digital Link resolver

Pasy se otevírají podle identity GS1 Digital Link. Resolver odpovídá ISO/IEC 18975 — normě, ne vlastnímu schématu.

Model, šarže, kus

Všechny tři úrovně granularity plus varianty výrobku. Stejný QR standard bez ohledu na to, kterou úroveň nakonec určí váš akt v přenesené pravomoci.

Koncept, náhled, publikace

Pas se připraví jako koncept, zkontroluje přes chráněný odkaz a publikuje, až je hotový. Každá verze zůstává v historii.

Auditní stopa na dotaz

Kdo co změnil — podle objektu, uživatele, výrobce, operátora, platformy. Ne jeden dlouhý žurnál, ale otázka s odpovědí.

24 jazyků programově

Hodnoty pasu se spravují po jazycích. Automatický překlad se zapíná a vypíná pro každý pas zvlášť.

Co pokrývá programový přístup

Každou z těchto oblastí lze řídit zcela přes API, bez ručního kroku v rozhraní.

Životní cyklus pasu

✅ Vytvoření, úprava, koncept, náhled přes chráněný odkaz, publikace a plná historie verzí.

Šablony

✅ Tvorba a verzování šablon, stav každé verze, překlady po jazycích a zakázkové šablony přiřazené konkrétnímu výrobci.

Organizace

✅ Platformy, operátoři a výrobci s adresami a kontakty — včetně převodu vlastnictví.

Propojení operátor ↔ výrobce

✅ Pozvánky s kódem, náhled před přijetím, přijetí jménem vlastní organizace a zrušení vazby.

Soubory a doklady

✅ Zabezpečené nahrávání, historie verzí u každého souboru a podepsané odkazy ke stažení s omezenou platností.

Auditní stopa

✅ Dotazy podle objektu, aktéra a organizace — určeno pro odpověď auditorovi, ne pro listování žurnálem.

Statistiky

✅ Ukazatele a časové řady podle rozsahu — pro vaše dashboardy, nejen pro náš.

Přístup a tokeny

✅ Osobní přístupové tokeny vydávané a odebírané po uživatelích, s administrativním dohledem.

Taxonomie

✅ Předpisy a skupiny výrobků jako data — nová skupina výrobků se přidá, nepředělává.

Veřejné čtení

✅ Otevření pasu přes GS1 Digital Link na úrovni modelu, šarže nebo kusu, včetně variant; stažený pas odpovídá rozlišitelně, ne mlčky.

API a integrace

Časté dotazy

Question Mark Section Supporting Image

Ano. Úplná specifikace OpenAPI není volně publikována, ale posíláme ji každému týmu, který připravuje integraci — stačí si říct. Dokumentace se tak dostane k lidem, kteří ji používají, a ne k těm, kdo ji kopírují.

Ano. Rozhraní je klientem téhož programového přístupu, jaký dostanete vy. To je rozdíl mezi platformou s API a platformou, ke které bylo API dodatečně přidáno.

Ano. Vytváření a aktualizace pasů, nahrávání dokumentů i správa organizací jsou programové operace, takže je váš systém může volat přímo. Který integrační vzor je ten pravý, závisí na vašem systému — to je rozhovor s naším inženýrem, ne hotový recept.

Přes GS1 Digital Link — standardní způsob, jak QR kód ukazuje na výrobek. Resolver odpovídá ISO/IEC 18975 a samotná identita staví na GTIN.

Odpověď je rozlišitelná. Pas, který byl publikován a už neplatí, se netváří, že nikdy neexistoval — systém, který jej čte, rozdíl pozná a může zareagovat správně.

Zatím ne. EPCIS 2.0 je plánované rozšíření pro odvětví s intenzivní sledovatelností; základní pas jej nevyžaduje. Raději to řekneme, než abychom to nechali předpokládat.

Technický tým na pracovní schůzce — integrace platformy DPP.
Otevřené StandardyProgramový Přístup
Otevřené StandardyProgramový Přístup
Naposledy ověřeno