Api-blueprint: Suporte a vários cabeçalhos HTTP

Criado em 26 jul. 2016  ·  3Comentários  ·  Fonte: apiaryio/api-blueprint

Parece que o API Blueprint não permite vários cabeçalhos HTTP.

De acordo com seu antigo RFC 2616 , é possível ter vários cabeçalhos HTTP. RFC 7230 deixa isso mais claro:

   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).

Coisas como Prefer e Link cabeçalhos são freqüentemente apresentados em linhas individuais para legibilidade.

Atualmente, o API Blueprint requer que você os apresente em uma única linha como uma lista separada por vírgulas (o que é bom o suficiente), mas torná-la mais legível permitindo que sejam escritos em linhas separadas, seria o ideal.

Obrigado!
:cartola:

Language Confirmed Bug

Todos 3 comentários

Para completar, os cabeçalhos Set-Cookie e Link são "tolerados" pelo analisador. A questão é se:

  1. Mantenha a lista branca de cabeçalhos que podem aparecer várias vezes
  2. Remova este aviso completamente

Parece que eu e @BigBlueHat estamos

Notas sobre a implementação atual https://github.com/apiaryio/snowcrash/issues/75#issuecomment -58886108

Remover o aviso tem a vantagem de permitir que as pessoas criem seus próprios cabeçalhos personalizados, que podem ser potencialmente definidos como tendo valores de lista separados por vírgulas. É difícil saber o futuro, então "seja liberal no que você aceita dos outros." :sorriso:

Esta página foi útil?
0 / 5 - 0 avaliações

Questões relacionadas

Perni1984 picture Perni1984  ·  6Comentários

bennettellis picture bennettellis  ·  7Comentários

robbinjanssen picture robbinjanssen  ·  6Comentários

fh-thudson picture fh-thudson  ·  3Comentários

spark-developer picture spark-developer  ·  12Comentários