Api-blueprint: دعم رؤوس HTTP متعددة

تم إنشاؤها على ٢٦ يوليو ٢٠١٦  ·  3تعليقات  ·  مصدر: apiaryio/api-blueprint

يبدو أن مخطط 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 حاليًا أن تقدمها على سطر واحد كقائمة مفصولة بفاصلة (وهو أمر جيد بما فيه الكفاية) ، ولكن جعلها أكثر وضوحًا من خلال السماح لكتابتها على أسطر منفصلة ، سيكون مثاليًا.

شكرا!
:قبعة عالية:

Language Confirmed Bug

ال 3 كومينتر

للتأكد من اكتمالها ، يتم "التسامح" مع رأس Set-Cookie و Link بواسطة المحلل اللغوي. السؤال هو ما إذا:

  1. احتفظ بالقائمة البيضاء للرأس التي يمكن أن تظهر عدة مرات
  2. قم بإزالة هذا التحذير تمامًا

يبدو مثلي و BigBlueHat على

ملاحظات حول التنفيذ الحالي https://github.com/apiaryio/snowcrash/issues/75#issuecomment -58886108

تتميز إزالة التحذير بميزة السماح للأشخاص بإنشاء رؤوس مخصصة خاصة بهم والتي يمكن تعريفها على أنها تحتوي على قيم قائمة مفصولة بفواصل. من الصعب معرفة المستقبل ، لذا "كن ليبراليًا فيما تقبله من الآخرين". :ابتسامة:

هل كانت هذه الصفحة مفيدة؟
0 / 5 - 0 التقييمات