取用陳述

每個陳述式的運作都以「消費者」為設計考量;這個陳述式的消費者會閱讀並驗證主體撰寫的聲明,然後根據該聲明採取行動。具體來說,消費者會執行以下基本步驟:

  1. 向特定主體索取對帳單清單
  2. 查看清單是否包含對指定目標的指定陳述式
  3. 確認聲明中的目標是否為您認為是目標 (網站或應用程式)
  4. 您可以選擇按照陳述式指定的動作,選擇

許多用途都使用幕後花絮。舉例來說,Android 應用程式連結會使用網站提供的連結權限陳述式,直接啟用應用程式的連結。應用程式會在其資訊清單中加入特殊程式碼 (意圖處理常式),表示應用程式同意這類聲明的目標。

執行 API 與步驟 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 介面完成這項作業。

請特別留意 Digital Asset Links 聲明的具體含義。如果您不確定,請參閱資產連結規格