Кажется, что API Blueprint не позволяет использовать несколько заголовков HTTP.
Согласно старому RFC 2616 возможно иметь несколько заголовков HTTP. RFC 7230 поясняет:
A sender MUST NOT generate multiple header fields with the same field
name in a message unless either the entire field value for that
header field is defined as a comma-separated list [i.e., #(values)]
or the header field is a well-known exception (as noted below).
Такие вещи, как заголовки Prefer
и Link
, часто представлены в отдельных строках для удобства чтения.
В настоящее время API Blueprint требует, чтобы вы представляли их в одной строке в виде списка, разделенного запятыми (что вполне нормально), но было бы идеально сделать его более разборчивым, позволив записывать их на отдельных строках.
Спасибо!
: tophat:
Для полноты, синтаксический анализатор "допускает" заголовки Set-Cookie
и Link
. Вопрос в том, есть ли:
Похоже, я и @BigBlueHat готовы полностью удалить предупреждение ...
Примечания к текущей реализации https://github.com/apiaryio/snowcrash/issues/75#issuecomment -58886108
Удаление предупреждения имеет то преимущество, что позволяет людям создавать свои собственные настраиваемые заголовки, которые потенциально могут быть определены как содержащие значения списка, разделенные запятыми. Трудно знать будущее, поэтому «будьте либеральны в том, что вы принимаете от других». :улыбка: