لقد اعتدت على الحصول على رقم الإصدار في عنوان URL نفسه (/v1/). أنا شخصياً أعتقد أن هذا نهج أكثر نظافة - بهذه الطريقة ، لا يحتاج المستخدم النهائي (أو المطور) إلى التعامل مع رؤوس HTTP ، ويمكنه ببساطة تعديل API/Call للوصول إلى إصدارات مختلفة من واجهة برمجة التطبيقات حسب الحاجة.
أعتقد أنه من الممكن أيضًا أن لا يتمتع بعض واجهات برمجة تطبيقات HTTP الموجودة في لغات مختلفة بدعم كامل لرؤوس HTTP ، لذلك يمكنك دائمًا جعل واجهة برمجة التطبيقات متاحة بسهولة للمستخدم النهائي. إعادة كتابة عنوان URL هي أبسط طريقة ، ويجب أن تعمل مع أي شيء يدعم HTTP هناك.
أخيرًا ، السماح بتحديد إصدار API باستخدام عنوان URL يتيح اختبارًا بسيطًا باستخدام متصفح الويب. إذا قمت بدمج الإصدار في رأس HTTP ، فسيُجبر المطور على استخدام لغة برمجة لإجراء الاختبار.