跳到主要内容

调用第一个 gRPC 请求

要开始使用 gRPC,请创建一个请求并使用 echo 端点调用它。

关于 API 请求

API 为一个应用程序提供了一种结构化的方式来访问另一个应用程序的功能。通常,这种通信通过 API 服务器在互联网上发生。客户端应用程序(如移动应用程序)向服务器发送请求,请求处理后,服务器向客户端返回响应。

gRPC 请求包含托管服务的服务器 URL、要在服务器上调用的方法,以及包含消息和有关如何执行请求的所需信息的请求负载。由于 gRPC 是模式驱动的框架,因此请求还需要有一个服务定义(模式)引用,其中包含有关服务器支持的服务、方法、消息字段和数据类型的信息。客户端必须遵循服务定义以避免错误。

gRPC 支持四种类型的方法,允许客户端和服务器根据所需用例以不同方式进行交互:

  • 一元- 传统的请求-响应通信模式也出现在 HTTP 中,其中客户端发出请求,服务器返回响应。
  • 客户端流- 客户端向服务器发送一系列消息,服务器在处理它们后返回响应。
  • 服务器流- 客户端需要向服务器发出单个请求以返回带有消息流的响应。
  • 双向流式传输——客户端和服务器可以通过持久会话相互异步通信。

创建和调用请求

此示例将创建并执行一元请求。要了解如何调用其他方法类型,请参阅 使用 gRPC 请求接口

如果你使用的是 Postman Web 应用程序,Postman 建议使用 Postman Desktop Agent 以获得最佳体验。有关详细信息,请参阅 关于 Postman 代理。

  1. 在 Postman 中,选择 “新建”>“gRPC”以在新选项卡中打开请求。(在 Postman 桌面应用程序中,你还可以选择⌘+NCtrl+N,然后选择gRPC。)

    新的 gRPC 请求

  2. 在 Server URL中输入一个 URL 。对于此示例,使用 Postman gRPC echo 服务,即grpc.postman-echo.com.

  3. 选择方法选择下拉菜单并浏览支持的服务和方法。当你输入 URL 时,Postman 会使用服务器反射(如果服务器支持)自动加载服务定义。如果服务器不支持服务器反射,则必须手动加载服务定义。 了解有关使用服务定义的 更多信息。

  4. 从方法列表中,向下滚动并选择SayHello。这是一个一元方法。

  5. 转到Message 区域并选择Generate example message。这会使用服务定义本身创建一个示例消息,这样你就不必设置正确的字段和数据类型。

  6. 将示例字符串数据替换为你的姓名(或任何其他字符串)并选择Invoke

调用该方法后,服务器将处理传递的信息并返回响应。

下一步

尝试调用 gRPC bin 服务器上可用的一些其他方法,看看事情有何不同。

完成后,了解有关 使用 gRPC 请求接口的 更多信息。