查询参数类型

本节介绍如何将一些常见数据类型作为查询参数传递。

如果您正在向 API 端点发送请求，并且没有使用我们的 JS 客户端，这将非常有用。例如，当使用 cURL 或 Postman 时。

Pet

integer <int64>

宠物ID

可选

字符串

您可以以 <parameter_name>=<value> 的形式传递字符串值。
例如：

如果字符串包含除字母和数字以外的任何字符，则必须
对其进行编码。
例如，如果字符串包含空格，您可以使用 + 或
%20 对空格进行编码：

您可以使用像这个这样的工具来了解
如何对值进行编码。

您可以以 <parameter_name>=<value> 的形式传递整数。
例如：

您可以以 <parameter_name>=<value> 的形式传递布尔值。
例如：

您可以以 <parameter_name>=<value> 的形式传递日期值。日期
必须采用 YYYY-MM-DD 格式。
例如：

您还可以使用 YYYY-MM-DDTHH:MM:SSZ 格式传递时间。请
注意，这里的 T 和 Z 是固定的。
例如：

每个数组值都必须以 <parameter_name>[]=<value> 的形式作为单独的查询参数传递。您也可以在括号中指定每个
参数的索引 <parameter_name>[0]=<value>。
例如：

请注意，传递给 curl 的 -g 参数会禁用因使用括号而抛出的错误。阅读更多
这里。

对象参数必须以 <parameter_name>[<key>]=<value> 的形式作为单独的查询参数传递。
例如：