يبدو أن مخطط API لا يسمح برؤوس HTTP متعددة.
وفقًا لـ RFC 2616 ، من الممكن أن يكون لديك عدة رؤوس HTTP. يوضح RFC 7230 الأمر بشكل أكثر وضوحًا:
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).
غالبًا ما يتم تقديم أشياء مثل الرؤوس Prefer
و Link
في سطور فردية من أجل الوضوح.
تتطلب API Blueprint حاليًا أن تقدمها على سطر واحد كقائمة مفصولة بفاصلة (وهو أمر جيد بما فيه الكفاية) ، ولكن جعلها أكثر وضوحًا من خلال السماح لكتابتها على أسطر منفصلة ، سيكون مثاليًا.
شكرا!
:قبعة عالية:
للتأكد من اكتمالها ، يتم "التسامح" مع رأس Set-Cookie
و Link
بواسطة المحلل اللغوي. السؤال هو ما إذا:
يبدو مثلي و BigBlueHat على
ملاحظات حول التنفيذ الحالي https://github.com/apiaryio/snowcrash/issues/75#issuecomment -58886108
تتميز إزالة التحذير بميزة السماح للأشخاص بإنشاء رؤوس مخصصة خاصة بهم والتي يمكن تعريفها على أنها تحتوي على قيم قائمة مفصولة بفواصل. من الصعب معرفة المستقبل ، لذا "كن ليبراليًا فيما تقبله من الآخرين". :ابتسامة: