כל הצהרה מותאמת אישית לצורכי צרכן. למעשה, ההצהרה לצרכן היא זו שקוראת ומאמתת הצהרה שנמסרה על ידי חשבון המשתמש, ואז פועלת על סמך ההצהרה הזו. ספציפית, הצרכן מבצע את השלבים הבסיסיים הבאים:
- בקשת רשימת דוחות מחשבון משתמש ספציפי
- לבדוק אם הרשימה מכילה הצהרה נתונה ביחס ליעד נתון
- מוודאים שהיעד בהצהרה הוא היעד (אתר או אפליקציה) שלדעתכם הוא
- עליך לבצע את הפעולה שצוינה בהצהרה, אם תבחר
תרחישים לדוגמה רבים צורכים אתכם מאחורי הקלעים. לדוגמה, קישור אפליקציות ל-Android צורך הצהרות הרשאת קישור שנוצרו על ידי אתר כדי לאפשר קישורים ישירות לאפליקציה. אפליקציה מציינת שהיא מסכימה כיעד של הצהרות כאלה על ידי הוספת קוד מיוחד (מטפל כוונה) במניפסט שלו.
ניתן לבצע את שלבים 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.
יש לשים לב במיוחד למילים הספציפיות בנוגע להצהרות על קישורים של נכסים דיגיטליים. אם אינכם בטוחים, כדאי לעיין במפרט של קישורי נכסים.