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:
Para completar, os cabeçalhos Set-Cookie
e Link
são "tolerados" pelo analisador. A questão é se:
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: