跳到主要内容

了解 gRPC 类型

当发送或接收 gRPC 请求或响应时,来回发送的消息以称为 protobuf(协议缓冲区) 的格式传输。与其他基于文本的数据格式(例如 JSON 或 XML)不同,protobuf 使用二进制格式。二进制格式不适合人类阅读,因此 Postman 提供了一个JSON 接口,使你可以在使用 gRPC 时读写数据。

JSON 接口

Protobuf 类型JSON 类型JSON 示例笔记
信息目的{ "field": 123 }null是所有字段类型的可接受值,并被视为相应字段类型的默认值。
枚举字符串数字"FOO_BAR"枚举名称和整数值都被接受。
重复 V大批[v, ...]
地图<K, V>目的{ "k": v }所有键都转换为字符串。
布尔值布尔值true,false
细绳细绳"Hello World!"
字节base64 字符串字节数组(数字 [0, 255]"SGVsbG8gZ1JQQw=="
int32、sint32、uint32、固定 32、sfixed32数字1, -10,0
int64, sint64, uint64, fixed64, sfixed64数字字符串"-1152921504606847254"十进制字符串用于提高与缺少 64 位整数的语言的兼容性。
浮动,双号码 "NaN" "Infinity" "-Infinity"1.1, -10.0, 0,"NaN"

检查字段和类型

在为 gRPC 请求编写消息时,你将数据作为 JSON 输入。在内部,该 JSON 表示 Protocol Buffers 数据。例如,你可以输入一个 base64 JSON 字符串以bytes在 Protocol Buffers 中表示。

Postman 使用 你选择的服务定义 在你撰写邮件时提供丰富的类型信息。当你将鼠标悬停在各种 JSON 字段或值上时,工具提示将解释该 JSON 字段或值的底层 Protocol Buffers 类型。这可以帮助你记住如何输入某些类型的数据,或了解内部发生的情况。

gRPC 类型检查