API i integracje
Platforma jest API-first
Wszystko, co robi ekran, przechodzi przez API
WIARA powstała jako API, zanim powstała jako interfejs. Panel, którego używacie, rozmawia z tym samym interfejsem programistycznym, który otrzymujecie i wy — nie ma trybu ukrytego ani funkcji dostępnej wyłącznie przez przycisk. Integracja nie jest więc dodatkiem do platformy; jest samą platformą.
Interfejsy są dwa. Jeden służy do integracji i administracji — ponad sto operacji udokumentowanych zgodnie z OpenAPI 3.0.3: paszporty, szablony, organizacje, pliki, ślad audytowy, statystyki. Drugi jest publiczny i tylko do odczytu, i to przez niego świat otwiera same paszporty.
Pełną specyfikację wysyłamy zespołom, które integrują — wystarczy o nią poprosić. Zobaczcie także standardy techniczne, na których stoi platforma, albo sam produkt →
Co możecie zautomatyzować
API i integracje
Co obejmuje dostęp programowy
Każdy z poniższych obszarów prowadzi się w całości przez API, bez ręcznego kroku w interfejsie.
Cykl życia paszportu
✅ Tworzenie, edycja, wersja robocza, podgląd przez chroniony link, publikacja i pełna historia wersji.
Szablony
✅ Tworzenie i wersjonowanie szablonów, status każdej wersji, tłumaczenia per język oraz szablony dedykowane przypisane konkretnemu producentowi.
Organizacje
✅ Platformy, operatorzy i producenci wraz z adresami i kontaktami — łącznie z przeniesieniem własności.
Powiązanie operator ↔ producent
✅ Zaproszenia z kodem, podgląd przed przyjęciem, przyjęcie w imieniu własnej organizacji i rozłączenie.
Pliki i dowody
✅ Bezpieczne przesyłanie, historia wersji każdego pliku i podpisane linki do pobrania o ograniczonej ważności.
Ślad audytowy
✅ Zapytania według obiektu, autora i organizacji — zrobione po to, by odpowiedzieć audytorowi, a nie po to, by je przewijać.
Statystyki
✅ Wskaźniki i szeregi czasowe według zakresu — dla waszych pulpitów, nie tylko dla naszego.
Dostęp i tokeny
✅ Osobiste tokeny dostępu wydawane i odbierane per użytkownik, z nadzorem administracyjnym.
Taksonomia
✅ Rozporządzenia i grupy produktów trzymane jako dane — nową grupę się dodaje, a nie przebudowuje.
Odczyt publiczny
✅ Otwarcie paszportu przez GS1 Digital Link na poziomie modelu, partii lub sztuki, z wariantami; wycofany paszport odpowiada rozróżnialnie, a nie milcząco.
API i integracje
Najczęstsze pytania
Tak. Interfejs jest klientem tego samego dostępu programowego, który otrzymujecie wy. To różnica między platformą z API a platformą, do której API dodano.
Tak. Tworzenie i aktualizacja paszportów, przesyłanie dokumentów i zarządzanie organizacjami to operacje programowe, więc wasz system może je wywoływać bezpośrednio. Który wzorzec integracji jest właściwy, zależy od waszego systemu — to rozmowa z naszym inżynierem, a nie gotowa recepta.
Przez GS1 Digital Link — standardowy sposób, w jaki kod QR wskazuje produkt. Resolver jest zgodny z ISO/IEC 18975, a sama tożsamość opiera się na GTIN.
Odpowiedź jest rozróżnialna. Paszport, który był opublikowany i już nie obowiązuje, nie udaje, że nigdy nie istniał — system, który go czyta, widzi różnicę i może zareagować właściwie.
Jeszcze nie. EPCIS 2.0 to planowane rozszerzenie dla branż o intensywnej identyfikowalności; paszport podstawowy go nie wymaga. Wolimy to powiedzieć, niż pozwolić, by zostało założone.
