Parece que API Blueprint no permite múltiples encabezados HTTP.
De acuerdo con la RFC 2616 anterior , es posible tener múltiples encabezados HTTP. RFC 7230 lo aclara:
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).
Cosas como los encabezados Prefer
y Link
menudo se presentan en líneas individuales para mayor legibilidad.
API Blueprint actualmente requiere que los presente en una sola línea como una lista separada por comas (lo cual es lo suficientemente fino), pero hacerlo más legible al permitir que se escriban en líneas separadas, sería ideal.
¡Gracias!
:sombrero de copa:
Para completar, el analizador "tolera" los encabezados Set-Cookie
y Link
. La pregunta es si:
Parece que @BigBlueHat y dispuestos a eliminar la advertencia por completo ...
Notas sobre la implementación actual https://github.com/apiaryio/snowcrash/issues/75#issuecomment -58886108
Eliminar la advertencia tiene la ventaja de permitir que las personas creen sus propios encabezados personalizados que podrían definirse como valores de lista separados por comas. Es difícil saber el futuro, así que "sé liberal en lo que aceptas de los demás". :sonrisa: