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

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

關(guān)于 API 請求

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

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

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

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

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

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

如果您使用的是 Postman Web 應(yīng)用程序，Postman 建議使用 Postman Desktop Agent 以獲得最佳體驗(yàn)。有關(guān)詳細(xì)信息，請參閱關(guān)于 Postman 代理。

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

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

下一步

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

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