כל הצהרה נוצרת מתוך מחשבה על צרכן; הצרכן בהצהרה הוא זה שקורא ומאמת הצהרה שנכתבה על ידי חשבון משתמש, ולאחר מכן נוקט פעולה על סמך אותה הצהרה. באופן ספציפי יותר, הצרכן מבצע את הפעולות הבסיסיות הבאות:
- בקשה להצגת רשימת דפי חשבון מחשבון משתמש ספציפי
- בודקים אם הרשימה מכילה הצהרה מסוימת שמתייחסת ליעד נתון
- בודקים שהיעד בהצהרה הוא היעד (אתר או אפליקציה) שלדעתכם הוא
- תבצעו את הפעולה שצוינה בהצהרה, אם תבחרו
תרחישים לדוגמה רבים צורכים הצהרות שמתייחסות אליכם מאחורי הקלעים. לדוגמה, 'קישור של אפליקציות ל-Android' משתמש בהצהרות על הרשאות קישור שנוצרו על ידי אתר מסוים כדי להפעיל קישורים ישירות לאפליקציה. אפליקציה מציינת שהיא מסכימה להיות יעד להצהרות כאלה באמצעות הוספה של קוד מיוחד (handler Intent) במניפסט שלה.
ניתן לבצע את שלבים 1 ו-2 שלמעלה – בקשה ואימות של הצהרה – בשתי דרכים: באמצעות ה-API שלנו או באופן ידני (באמצעות הטמעה משלכם).
שימוש בהצהרות באמצעות Digital Asset Links API
ה-Digital Asset Links API תומך בשתי שיטות: Check() ו-List() לחיפוש או לאימות של דפי חשבון:
Check()לוקחת מקור, יעד וקשר, ומאמתת שהמקור יוצר את ההצהרה שנשלחה לגבי היעד.List()מפרטת את כל ההצהרות שנאמרו על ידי מקור נתון.
שימוש בדוחות באופן ידני
פרוטוקול Digital Asset Links פתוח, כך שאתם יכולים ליצור בו הטמעה בעצמכם.
כדי לצרוך הצהרות שפורסמו על ידי אתרי אינטרנט, תוכלו לשלוח בקשת HTTP GET לרשימת ההצהרה המתאימה ולנתח אותה בעצמכם. לדוגמה, רשימת דפי החשבון התואמת לאתר http://example.digitalassetlinks.org נמצאת בכתובת http://example.digitalassetlinks.org/.well-known/assetlinks.json.
כדי לצרוך הצהרות מטעם אפליקציות ל-Android, עליך לגשת למניפסט של חבילת ה-APK המתאימה. במכשירי Android, ניתן לעשות זאת באמצעות הממשק של PackageManager.
חשוב לשים לב למשמעויות הספציפיות של ההצהרות על קישורים לנכסים דיגיטליים. אם אתם לא בטוחים, כדאי לעיין במפרט הקישורים לנכסים.