Api-blueprint: Unterstützt mehrere HTTP-Header
Es scheint, dass API Blueprint nicht mehrere HTTP-Header zulässt.
Nach altem RFC 2616 ist es möglich, mehrere HTTP-Header zu haben. RFC 7230 macht es klarer:
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).
Dinge wie die Prefer und Link Gründen der Lesbarkeit oft in einzelnen Zeilen dargestellt.
API Blueprint erfordert derzeit, dass Sie sie in einer einzigen Zeile als durch Kommas getrennte Liste darstellen (was in Ordnung ist), aber es wäre ideal, sie besser lesbar zu machen, indem Sie sie in separate Zeilen schreiben lassen.
Vielen Dank!
:tophat:
BigBlueHat
Alle 3 Kommentare
Der Vollständigkeit halber werden die Header Set-Cookie und Link vom Parser "toleriert". Frage ist ob:
- Behalten Sie die weiße Liste der Kopfzeilen bei, die mehrmals erscheinen können
- Entfernen Sie diese Warnung vollständig
Scheint, als ob ich und @BigBlueHat bereit sind, die Warnung ganz zu entfernen ...
zdne
am 26. Juli 2016
Hinweise zur aktuellen Implementierung https://github.com/apiaryio/snowcrash/issues/75#issuecomment -58886108
zdne
am 26. Juli 2016
Das Entfernen der Warnung hat den Vorteil, dass Benutzer ihre eigenen benutzerdefinierten Header erstellen können, die möglicherweise als durch Kommas getrennte Listenwerte definiert werden könnten. Es ist schwer, die Zukunft zu kennen, also "sei liberal in dem, was du von anderen akzeptierst." :Lächeln:
BigBlueHat
am 26. Juli 2016
Verwandte Themen
bazo
·
8Kommentare
AlexKorovyansky
·
4Kommentare
fh-thudson
·
3Kommentare
pete001
·
6Kommentare
teja5429
·
9Kommentare