API閘道器使用案例 - Amazon API Gateway

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

API閘道器使用案例

下列使用案例區段會概述 Gateway 的不同類型,以APIs及使用 API API Gateway 的不同開發人員種類。如需RESTAPIs和之間差異的更多詳細資訊 HTTPAPIs,請參閱在RESTAPIs和之間選擇 HTTP APIs

使用API閘道建立 REST APIs

API閘道RESTAPI是由資源和方法組成。資源是應用程式可透過資源路徑存取的邏輯實體。一種方法對應於由您的用戶提交的RESTAPI請求,API並返回給用戶的響應。

例如,/incomes 可以是代表應用程式使用者收入之資源的路徑。資源可以具有由適當HTTP動詞定義的一個或多個操作GET,例如 POSTPUT,PATCH,,和DELETE。資源路徑和作業的組合可識別的方法API。例如,POST /incomes 方法可新增發起人所獲得的收入,而 GET /expenses 方法可查詢發起人所產生的報告費用。

應用程式不必知道在後端存放和擷取所請求資料的位置。在 API Gateway 中 RESTAPIs,前端由方法請求和方法響應封裝。通過集成請求和集成響應的方式與後端的API接口。

例如,使用 DynamoDB 做為後端,API開發人員會設定整合請求,將傳入的方法請求轉寄至所選的後端。此設定包括適當 DynamoDB 動作的規格、必要的IAM角色和原則,以及必要的輸入資料轉換。後端會將結果作為整合回應傳回至API閘道。

若要將整合回應路由至指定HTTP狀態碼的適當方法回應至用戶端,您可以設定整合回應,將所需的回應參數從整合對應至方法。您接著會將後端的輸出資料格式翻譯為前端的輸出資料格式 (必要時)。APIGateway 可讓您定義承載的結構描述或模型,以便於設定主體對應範本。

API閘道提供下列RESTAPI管理功能:

  • Support 使用要開啟的API閘道擴充功能產生SDKs和建立API文件 API

  • 請求的節流 HTTP

使用API閘道建立 HTTP APIs

HTTPAPIsRESTfulAPIs使您能夠以更低的延遲和更低的成本進行創作RESTAPIs。

您可以使用HTTPAPIs將請求發送到 AWS Lambda 功能或任何可公開路由的HTTP端點。

例如,您可以在後端HTTPAPI建立與 Lambda 函數整合的功能。當用戶端呼叫您的時候API,APIGateway 會將請求傳送至 Lambda 函數,並將函數的回應傳回給用戶端。

HTTPAPIs支持 OpenID ConnectOAuth2.0 授權。它們具有跨來源資源共用 (CORS) 和自動部署的內建支援。

如需進一步了解,請參閱在RESTAPIs和之間選擇 HTTP APIs

使用API閘道建立 WebSocket APIs

在 a 中 WebSocket API,客戶端和服務器都可以隨時向對方發送消息。後端伺服器可以輕鬆地將資料發送至連線的使用者和裝置,進而免除了實作複雜的輪詢機制。

例如,您可以使用API閘道建立無伺服器應用程式, WebSocket API並 AWS Lambda 在聊天室中向個別使用者或使用者群組傳送和接收訊息。或者 AWS Lambda,您也可以根據訊息內容叫用後端服務,例如 Amazon Kinesis 或HTTP端點。

您可以使用 API Gateway WebSocket APIs 建置安全的即時通訊應用程式,而不必佈建或管理任何伺服器來管理連線或大規模資料交換。針對性使用案例包含即時的應用程式,如下所示:

  • 聊天應用程式

  • 股票行情之類的即時儀表板

  • 即時提醒和通知

API閘道提供下列 WebSocket API管理功能:

  • 對連線和訊息進行監控和調節

  • 用 AWS X-Ray 於在通過後端服務旅行APIs時跟踪消息

  • 輕鬆整合HTTP/HTTPS端點

誰使用API閘道?

使用 API Gateway 的開發人員有兩種:開發人API員和應用程式開發人員。

API開發人員會建立並部署API以啟用 API Gateway 中所需的功能。開API發人員必 AWS 須是擁有API.

應用程序開發人員通過調用 API Gateway 中的開發人API員 WebSocket 或RESTAPI創建來構建一個功能正常的應用程序來調用 AWS 服務。

應用程式開發人員是開API發人員的客戶。應用程式開發人員不需要 AWS 帳戶,前提是不需要IAM許可或支援透過 Amazon Cognito 使用者集區身分聯盟支援的第三方聯合身分提供者授權使用者。API這類身分提供者包含 Amazon、Amazon Cognito 使用者集區、Facebook 和 Google。

建立和管理API閘道 API

API開發人員使用API閘道服務元件進行API管理apigateway、命名、以建立、設定及部署API.

身為API開發人員,您可以使API用 API Gateway 主控台開始使用API閘道、中所述或呼叫API 參考. 有幾種方法可以調用它API。它們包括使用 AWS Command Line Interface (AWS CLI) 或使用 AWS SDK. 此外,您可以啟用使用AWS CloudFormation 範本API建立或 (在RESTAPIs和的情況下 HTTPAPIs) 開啟API閘道的API擴充功能

如需API閘道可用的區域清單,以及相關的控制服務端點,請參閱 Amazon API 閘道端點和配額

呼叫API閘道 API

應用程序開發人員使用 API Gateway 服務組件API執行(命名execute-api為)以調API用在 API Gateway 中創建或部署的。基礎程式設計實體是由建立的公開API。有幾種方法可以調用這樣的API. 如需了解詳細資訊,請參閱 在 API Gateway 中叫用其餘 API叫用 WebSocket API