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

2023-04-04 09:29 更新

要開始使用 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。)新的 gRPC 請求
  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 請求接口的更多信息。


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號