Api-blueprint: 複数のHTTPヘッダーをサポート

作成日 2016年07月26日  ·  3コメント  ·  ソース: apiaryio/api-blueprint

APIブループリントは複数のHTTPヘッダーを許可していないようです。

あなたがたの古いRFC2616によれば、複数の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).

PreferLinkヘッダーのようなものは、読みやすくするために個々の行に表示されることがよくあります。

API Blueprintでは現在、コンマ区切りのリストとして1行で表示する必要がありますが(これで十分です)、別々の行に書き込むことができるようにすることで読みやすくするのが理想的です。

ありがとう!
:トップハット:

Language Confirmed Bug

全てのコメント3件

完全を期すために、 Set-CookieおよびLinkヘッダーはパーサーによって「許容」されます。 質問は次のとおりです。

  1. 複数回表示される可能性のあるヘッダーのホワイトリストを保持する
  2. この警告を完全に削除してください

私と@BigBlueHatが警告を完全に削除する

警告を削除すると、コンマ区切りのリスト値を持つものとして定義できる可能性のある独自のカスタムヘッダーを作成できるという利点があります。 将来を知るのは難しいので、 「他人から受け入れるものには寛大になりなさい」。 :笑顔:

このページは役に立ちましたか?
0 / 5 - 0 評価

関連する問題

AlexKorovyansky picture AlexKorovyansky  ·  4コメント

mootpointer picture mootpointer  ·  4コメント

fgblomqvist picture fgblomqvist  ·  3コメント

fh-thudson picture fh-thudson  ·  3コメント

robbinjanssen picture robbinjanssen  ·  6コメント