Każde stwierdzenie zostało zaprojektowane z myślą o konsumentach. Konsument to osoba, która czyta i weryfikuje oświadczenie złożone przez podmiot zabezpieczeń, a następnie na podstawie tego oświadczenia podejmuje odpowiednie działania. Mówiąc dokładniej, konsument wykonuje te podstawowe czynności:
- Prośba o listę zestawienia operacji od konkretnego podmiotu zabezpieczeń
- Sprawdź, czy lista zawiera określone wyrażenie względem danej wartości docelowej
- Udowodnij, że celem wymienionym w deklaracji jest cel (witryna lub aplikacja), który Twoim zdaniem jest tym celem
- Jeśli chcesz, wykonaj czynność określoną w instrukcji
W wielu przypadkach użycia wyrażenia te są odczytywane w tle. Na przykład funkcja łączenia aplikacji na Androida korzysta z instrukcji uprawnień do linków przygotowanych przez stronę internetową, aby umożliwiać bezpośrednie linki do aplikacji. Aplikacja wskazuje, że wyraża zgodę na kierowanie się takim instrukcją, dodając w pliku manifestu specjalny kod (moduł obsługi intencji).
Kroki 1 i 2 powyżej (żądanie i weryfikacja oświadczenia) możesz wykonać na 2 sposoby: za pomocą naszego interfejsu API lub ręcznie (korzystając z własnej implementacji).
Korzystanie z instrukcji za pomocą interfejsu Digital Asset Links API
Interfejs Digital Asset Links API obsługuje 2 metody: Check() i List() do znajdowania i weryfikowania instrukcji:
Check()bierze pod uwagę źródło, miejsce docelowe i relację oraz sprawdza, czy źródło składa oświadczenie dotyczące elementu docelowego.List()zawiera wszystkie instrukcje podane w danym źródle.
Ręczne korzystanie z instrukcji
Protokół Digital Asset Links jest otwarty, więc możesz samodzielnie utworzyć jego implementację.
Aby przetwarzać instrukcje przygotowane przez witryny internetowe, możesz wysłać żądanie HTTP GET dla odpowiedniej listy instrukcji i przeanalizować ją samodzielnie. Na przykład odpowiednia lista instrukcji dla witryny http://example.digitalassetlinks.org ma adres http://example.digitalassetlinks.org/.well-known/assetlinks.json.
Aby wykorzystać instrukcje przygotowane przez aplikacje na Androida, musisz uzyskać dostęp do pliku manifestu odpowiedniego pakietu APK. Na urządzeniach z Androidem można to zrobić za pomocą interfejsu PackageManager.
Zwróć szczególną uwagę na konkretne znaczenia deklaracji dotyczących linków do zasobów cyfrowych. Jeśli nie masz pewności, zapoznaj się ze specyfikacją linków do zasobów.