使用陳述式

每個陳述的重點都在於「消費者」;「消費者」陳述指的是閱讀及驗證由主體發表的陳述,並依據該陳述採取行動。具體來說,消費者會執行以下基本步驟:

  1. 向特定主體要求陳述式清單
  2. 檢查清單是否包含針對特定目標的指定陳述式
  3. 驗證陳述式中的目標是否為您認為其目標 (網站或應用程式)
  4. 如果您選擇執行以下動作,請執行陳述式指定的操作:

許多用途都會在幕後使用陳述式,舉例來說,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 介面完成這項作業。

請特別留意 Digital Asset Links 陳述的具體意義。如果不確定,請參閱「資產連結規格」一文。