Api-blueprint: Mendukung Beberapa Header HTTP

Dibuat pada 26 Jul 2016 · 3Komentar · Sumber: apiaryio/api-blueprint

Tampaknya Cetak Biru API tidak mengizinkan beberapa header HTTP.

Menurut Anda RFC 2616 yang lama dimungkinkan untuk memiliki beberapa header HTTP. RFC 7230 membuatnya lebih jelas:

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

Hal-hal seperti header Prefer dan Link sering disajikan pada baris individual untuk keterbacaan.

API Blueprint saat ini mengharuskan Anda menyajikannya dalam satu baris sebagai daftar yang dipisahkan koma (yang cukup bagus), tetapi membuatnya lebih mudah dibaca dengan mengizinkannya ditulis pada baris terpisah, akan menjadi ideal.

Terima kasih!
:pucuk topi:

Language Confirmed Bug

Sumber

BigBlueHat

Semua 3 komentar

Untuk kelengkapan, header Set-Cookie dan Link "ditoleransi" oleh parser. Pertanyaannya adalah apakah:

Simpan daftar putih tajuk yang dapat muncul beberapa kali
Hapus peringatan ini sepenuhnya

Sepertinya saya dan @BigBlueHat siap untuk menghapus peringatan sama sekali...

zdne pada 26 Jul 2016

👍1

Catatan tentang implementasi saat ini https://github.com/apiaryio/snowcrash/issues/75#issuecomment -58886108

zdne pada 26 Jul 2016

Menghapus peringatan memiliki keuntungan memungkinkan orang membuat tajuk khusus mereka sendiri yang berpotensi didefinisikan sebagai memiliki nilai daftar yang dipisahkan koma. Sulit untuk mengetahui masa depan, jadi "bersikaplah liberal dalam apa yang Anda terima dari orang lain." :senyum:

BigBlueHat pada 26 Jul 2016

👍1

Apakah halaman ini membantu?

0 / 5 - 0 peringkat