Postman 調(diào)用您的第一個 gRPC 請求

要開始使用 gRPC，請創(chuàng)建一個請求并使用 echo 端點調(diào)用它。

關于 API 請求

API 為一個應用程序提供了一種結構化的方式來訪問另一個應用程序的功能。通常，這種通信通過 API 服務器在互聯(lián)網(wǎng)上發(fā)生。客戶端應用程序（如移動應用程序）向服務器發(fā)送請求，請求處理后，服務器向客戶端返回響應。

gRPC 請求包含托管服務的服務器 URL、要在服務器上調(diào)用的方法，以及包含消息和有關如何執(zhí)行請求的所需信息的請求負載。由于 gRPC 是模式驅(qū)動的框架，因此請求還需要有一個服務定義（模式）引用，其中包含有關服務器支持的服務、方法、消息字段和數(shù)據(jù)類型的信息。客戶端必須遵循服務定義以避免錯誤。

gRPC 支持四種類型的方法，允許客戶端和服務器根據(jù)所需用例以不同方式進行交互：

• 一元- 傳統(tǒng)的請求-響應通信模式也出現(xiàn)在 HTTP 中，其中客戶端發(fā)出請求，服務器返回響應。
• 客戶端流- 客戶端向服務器發(fā)送一系列消息，服務器在處理它們后返回響應。
• 服務器流- 客戶端需要向服務器發(fā)出單個請求以返回帶有消息流的響應。
• 雙向流式傳輸——客戶端和服務器可以通過持久會話相互異步通信。

創(chuàng)建和調(diào)用請求

此示例將創(chuàng)建并執(zhí)行一元請求。要了解如何調(diào)用其他方法類型，請參閱使用 gRPC 請求接口。

如果您使用的是 Postman Web 應用程序，Postman 建議使用 Postman Desktop Agent 以獲得最佳體驗。有關詳細信息，請參閱關于 Postman 代理。

1. 在 Postman 中，選擇 新建 > gRPC 請求以在新選項卡中打開請求。（在 Postman 桌面應用程序中，您還可以選擇?+N或Ctrl+N，然后選擇gRPC Request。）
2. 在Server URL中輸入一個 URL 。對于此示例，使用 Postman gRPC echo 服務，即grpc.postman-echo.com.
3. 選擇方法選擇下拉菜單并瀏覽支持的服務和方法。當您輸入 URL 時，Postman 會使用服務器反射（如果服務器支持）自動加載服務定義。如果服務器不支持服務器反射，則必須手動加載服務定義。了解有關使用服務定義的更多信息。
4. 從方法列表中，向下滾動并選擇SayHello。這是一個一元方法。
5. 轉(zhuǎn)到Message 區(qū)域并選擇Generate example message。這會使用服務定義本身創(chuàng)建一個示例消息，這樣您就不必設置正確的字段和數(shù)據(jù)類型。
6. 將示例字符串數(shù)據(jù)替換為您的姓名（或任何其他字符串）并選擇Invoke。

調(diào)用該方法后，服務器將處理傳遞的信息并返回響應。

下一步

嘗試調(diào)用 gRPC bin 服務器上可用的一些其他方法，看看事情有何不同。

完成后，了解有關使用 gRPC 請求接口的更多信息。