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

Question

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

我正在消息资源端点（尤其是列表消息）上使用增量查询。

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

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

docs中没有任何示例显示如何实现此目的。我不确定是否需要将它们串联为单个值，还是要指定多个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

或者您可以将单个“首选项”标头字段与逗号分隔的值列表一起使用：

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