Api-blueprint: Поддержка нескольких заголовков HTTP

Созданный на 26 июл. 2016  ·  3Комментарии  ·  Источник: apiaryio/api-blueprint

Кажется, что 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:

Language Confirmed Bug

Все 3 Комментарий

Для полноты, синтаксический анализатор "допускает" заголовки Set-Cookie и Link . Вопрос в том, есть ли:

  1. Сохраните белый список заголовков, которые могут появляться несколько раз
  2. Полностью удалить это предупреждение

Похоже, я и @BigBlueHat готовы полностью удалить предупреждение ...

Примечания к текущей реализации https://github.com/apiaryio/snowcrash/issues/75#issuecomment -58886108

Удаление предупреждения имеет то преимущество, что позволяет людям создавать свои собственные настраиваемые заголовки, которые потенциально могут быть определены как содержащие значения списка, разделенные запятыми. Трудно знать будущее, поэтому «будьте либеральны в том, что вы принимаете от других». :улыбка:

Была ли эта страница полезной?
0 / 5 - 0 рейтинги