Как указать несколько «предпочтительных» заголовков?

Question

В настоящее время я создаю Ruby SDK для API Graph.

Я работаю с дельта-запросами на конечных точках ресурса сообщений, в частности списком сообщений.

Мне нужно указать два предпочтения, используя заголовок (-и) 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