Api-blueprint: Soporta múltiples encabezados HTTP

Creado en 26 jul. 2016  ·  3Comentarios  ·  Fuente: apiaryio/api-blueprint

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:

Language Confirmed Bug

Todos 3 comentarios

Para completar, el analizador "tolera" los encabezados Set-Cookie y Link . La pregunta es si:

  1. Mantenga la lista blanca de encabezados que pueden aparecer varias veces
  2. Eliminar esta advertencia por completo

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:

¿Fue útil esta página
0 / 5 - 0 calificaciones

Temas relacionados

danilvalov picture danilvalov  ·  3Comentarios

fgblomqvist picture fgblomqvist  ·  3Comentarios

annappropriate picture annappropriate  ·  5Comentarios

mootpointer picture mootpointer  ·  4Comentarios

spark-developer picture spark-developer  ·  12Comentarios