本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS Data Exchange 適用於 APIs （測試產品）
<a name="subscriber-tutorial-api-product"></a>

AWS Data Exchange for APIs（測試產品） 是一項免費產品，可供訂閱者了解如何與包含 API 資料集 AWS Data Exchange 的產品互動。您可以使用此產品進行測試，並了解如何對提供者進行 API 呼叫，以擷取 API 型資料。

AWS Data Exchange for APIs（測試產品） 包含名為 **AWS Data Exchange API APIs ** 資料集，其位於美國東部 （維吉尼亞北部） 區域。

**Topics**
+ [訂閱 AWS Data Exchange 適用於 APIs （測試產品）](subscribe-to-API-test-product.md)
+ [檢視 API](tutorial-view-api.md)
+ [下載 API 規格](tutorial-download-api-spec.md)
+ [進行 API 呼叫](tutorial-make-api-call-console.md)

# 在 上訂閱 AWS Data Exchange APIs（測試產品） AWS Data Exchange
<a name="subscribe-to-API-test-product"></a>

下列程序說明如何瀏覽 AWS Data Exchange 目錄以尋找和訂閱 AWS Data Exchange APIs （測試產品）。

**尋找並訂閱 AWS Data Exchange APIs （測試產品）**

1. 開啟 並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 在左側導覽窗格的**探索資料產品**下，選擇**瀏覽目錄**。

1. 從搜尋列輸入 **AWS Data Exchange for APIs**，然後按 **Enter**。

1. 選擇 **AWS Data Exchange APIs（測試產品）** 的 ，並檢視其詳細資訊頁面。

   1. （選用） 若要下載範例，請選擇**資料字典和範例**索引標籤，選擇範例名稱旁的選項按鈕 (**適用於 APIs.json 的 ADX**)，然後選擇**下載**。

1. 在右上角，選擇**繼續訂閱**。

1. 選擇**產品優惠**。
**注意**  
AWS Data Exchange for APIs（測試產品） 是免費產品。

1. 檢閱**訂閱條款**、**資料集**和**支援資訊**。

1. 選擇是否要為訂閱啟用**優惠自動續約**。
**注意**  
AWS Data Exchange 適用於 APIs（測試產品） 的 不需要訂閱驗證，但有些產品需要。如需詳細資訊，請參閱[中的訂閱者訂閱驗證 AWS Data Exchange](subscription-verification-sub.md)。

1. 選擇 **Subscribe (訂閱)**。

選擇訂閱後，您的訂閱可能需要幾分鐘才會變成作用中****。在訂閱變成作用中之前離開此頁面，並不會阻止訂閱處理。

# 檢視 AWS Data Exchange API
<a name="tutorial-view-api"></a>

您可以使用下列步驟檢視 AWS Data Exchange 適用於 API （測試產品） APIs。

**檢視 API**

1. 開啟 並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 從左側導覽窗格的**我的訂閱**下，選擇**授權資料**。

1. 選擇 API ****AWS Data Exchange** 的標題產品 APIs （測試產品）**，然後選擇 **AWS Data Exchange APIs資料集的** 。

1. 在**修訂**索引標籤下，選擇修訂。

1. 在 **API 資產**下，選擇 API。

1. 檢視**資產概觀**。

1. 遵循**整合備註**中的指引來呼叫 API。

# 下載 AWS Data Exchange API 規格
<a name="tutorial-download-api-spec"></a>

您可以使用 AWS Data Exchange 適用於 API （測試產品） APIs 規格，步驟如下。

**下載 API 規格**

1. 開啟 並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 從左側導覽窗格的**我的訂閱**下，選擇**授權資料**。

1. 選擇 API ****AWS Data Exchange** 的標題產品 APIs （測試產品）**，然後選擇 **AWS Data Exchange APIs資料集的** 。

1. 在**修訂**索引標籤下，選擇修訂。

1. 在 **API 資產**下，選擇 API。

1. 在 **OpenAPI 3.0 規格上**，選擇**下載 API 規格**。

   規格會下載到您的本機電腦。然後，您可以將資產匯出到第三方工具以產生 SDK。

# 進行 AWS Data Exchange API 呼叫
<a name="tutorial-make-api-call-console"></a>

您可以在 AWS Data Exchange 主控台中呼叫單一端點。

**從主控台進行 API 呼叫**

1. 開啟 並登入 [AWS Data Exchange 主控台](https://console.aws.amazon.com/dataexchange)。

1. 從左側導覽窗格的**我的訂閱**下，選擇**具備權限的資料**。

1. 選擇 API ****AWS Data Exchange** 的標題產品 APIs （測試產品）**，然後選擇 **AWS Data Exchange APIs資料集的** 。

1. 在**修訂**索引標籤下，選擇修訂。

1. 在 **API 資產**下，選擇 API。

   您將看到範例**程式碼結構**和 **OpenApi 3.0 規格**來建構 API 請求，您可以在 中使用它 AWS Command Line Interface 來呼叫 API。

1. 在**整合備註**下，選擇**複製**以複製**程式碼結構**，然後將其貼入 AWS CLI。

1. 使用規格文件中的資訊，將範例值取代為您需要的參數鍵值對。

   以下是適用於 **AWS Data Exchange API （測試產品） APIs **請求範例。

   ```
   aws dataexchange send-api-asset \
     --data-set-id 8d494cba5e4720e5f6072e280daf70a8 \
     --revision-id b655d5be3da04fcbdca21a5a2932d789 \
     --asset-id 8550cfab16b444a794402f2c3f11eae1 \
     --method POST \
     --path "someresource" \
     --query-string-parameters 'param1=value1,param2=value2' \
     --request-headers 'header=header_value' \
     --body "{\"body_param\":\"body_param_value\"}"
   ```