建立連線

與 Google 交換金鑰並取得供應商 ID (PIAID) 之後,您就能與 Client Side Push Provisioning API 建立連線,並順利完成 echo 測試。我們提供程式碼範例,協助您使用我們交換的加密金鑰來執行這些測試,確保相關設定正確無誤,且基礎架構能將我們的要求正確轉送至主機。使用程式碼範例順利完成 echo 測試之後,您就能更新實作項目,與 API 相互通訊。

由合作夥伴傳送 echo 給 Google

Google 負責代管 echo 端點。您可以呼叫這個端點,測試是否能與我們的伺服器相互通訊。您須使用與 Google 交換的加密金鑰來產生 echo 要求並剖析回應。

使用我們的程式碼範例傳送 echo 給 Google

任一程式碼範例設定完成並開始運作之後,您可以使用 curl 或類似的工具來觸發 echo 要求,如下所示:

curl -H "Content-type: text/plain" -X POST -d ‘hello’ https://{YOUR_HOST}/echo

如果金鑰設定正確無誤,您應該會看到成功的 echo 回應。

Echo 要求程式碼範例

對初始開發期間發生的錯誤進行除錯以便建立連線並不容易,因為我們的 API 對含有 PGP 加密錯誤的要求會傳回 404 錯誤訊息。此外,所有回應都會進行加密,並以八位元串流的形式傳送,導致初始連線工作變得更加複雜。

為此,我們提供了幾項資源,協助您開始使用:

  • 加密與解密的 Java 實作
  • 示範如何成功執行雙向 echo 測試的程式碼範例
  • 提供程式碼範例逐步操作說明的程式碼研究室

下載程式碼範例

下列程式碼範例均能正常運作,可用於呼叫 Google 代管的 echo API。請注意,這些範例會一併包含用於代管您 echo 端點的程式碼。由於 Client Side Push Provisioning API 不需要該功能,因此請著重於將 echo 要求傳送至 Google 端點。

Java Node.js

程式碼研究室逐步操作說明

下列程式碼研究室會逐步介紹 Java 和 Node.js 實作範例,協助您快速瞭解其運作方式,以及需經調整才能順利運作的重要設定。

Java Node.js