如何指定多个“首选”标题？

Question

我目前正在为 Graph API 构建一个 Ruby SDK。

我正在处理消息资源端点上的增量查询，特别是列表消息。

我需要使用Prefer标头指定两个首选项：

1. 允许不安全的 HTML - "outlook.allow-unsafe-html"
2. 每页/请求的最大项目数 - "odata.maxpagesize={num}"

文档中没有任何示例说明如何实现这一点。我不确定它们是否需要连接成一个值或是否指定多个 HTTP 标头（或者是否甚至支持）。这里的澄清将非常有帮助

Answer 1

根据RFC7240：

客户端可以在单个消息中使用多个 Prefer 头字段的实例，或者它可以使用单个 Prefer 头字段和多个逗号分隔的首选项令牌。如果使用多个 Prefer 头字段，则相当于单个 Prefer 头字段，其中所有令牌以逗号分隔连接。

因此，您可以使用多个Prefer标头字段定义不同的首选项：

 POST /foo HTTP/1.1
 Host: example.org
 Prefer: respond-async, wait=100
 Prefer: handling=lenient
 Date: Tue, 20 Dec 2011 12:34:56 GMT

或者，您可以使用带有逗号分隔值列表的单个 Prefer 标头字段：

 POST /foo HTTP/1.1
 Host: example.org
 Prefer: handling=lenient, wait=100, respond-async
 Date: Tue, 20 Dec 2011 12:34:56 GMT