[Postman] كيفية تمرير التاريخ الحالي كقيمة في طلب GET؟

يتضمن اختبار وتطوير API العديد من التفاصيل، بما في ذلك التاريخ الحالي ضمن طلبات GET. يمكن أن يكون هذا جانبًا حاسمًا في محاكاة السيناريوهات الواقعية.

تستكشف هذه المقالة طريقتين فعالتين لدمج التاريخ الحالي كقيمة طلب GET ضمن Postman، وهو عميل API مشهور. سنتناول استخدام نصوص ما قبل الطلب ومتغيرات البيئة، مما يجهزك بالأدوات اللازمة لبناء طلبات GET ديناميكية وقابلة للتكيف.

ما هو Postman؟

Postman يبسط عملية تطوير API للبرمجيين. يوفر مجموعة متنوعة من الميزات التي تسمح لهم بتصميم واختبار وتوثيق APIs كلها في مكان واحد. هذه المجموعة من الأدوات تجعل Postman الخيار المفضل للمطورين الذين يعملون على أي مشروع يتضمن APIs.

نصوص ما قبل الطلب في Postman

في Postman، نصوص ما قبل الطلب هي مقتطفات من كود JavaScript التي يتم تنفيذها قبل إرسال طلب API. تعمل كبوابة تحضير، مما يسمح لك بأداء الإجراءات والمعالجات على طلبك قبل أن يتم إرساله.

تعديل الطلب الديناميكي

تسمح لك نصوص ما قبل الطلب بتعديل طلبات API الخاصة بك أثناء التشغيل باستخدام JavaScript. هذا يمكن أن يجعلك تدمج عناصر ديناميكية مثل التاريخ الحالي أو بيانات اختبار عشوائية أو رموز وصول بناءً على سيناريوهات محددة.

إمكانية التكوين

يمكن كتابة هذه النصوص على مستويات مختلفة داخل Postman، مما يوفر مرونة:

• مستوى الطلب: النصوص المكتوبة هنا تكون خاصة بذلك الطلب المعين.
• مستوى المجموعة: النصوص في هذا المستوى تعمل قبل كل طلب داخل مجموعة.
• مستوى المجلد: تنطبق هذه النصوص على جميع الطلبات الفرعية داخل مجلد محدد.

إعادة الاستخدام المعززة

يمكن تصميم النصوص للاستفادة من البيانات من المتغيرات أو الطلبات السابقة، مما يعزز من إعادة الاستخدام ويقلل من الكود المتكرر.

تخصيص مكونات الطلب

يمكنك تعديل جوانب مختلفة من طلبك باستخدام نصوص ما قبل الطلب، بما في ذلك الرؤوس، محتوى الجسم، ومعلمات الاستعلام.

تصحيح الأخطاء وتسجيلها

تسمح لك هذه النصوص بتسجيل المعلومات في وحدة تحكم Postman، مما يساعد في تصحيح تفاعلات API الخاصة بك وحل أي مشكلات.

دليل خطوة بخطوة حول كيفية تمرير التاريخ الحالي كقيمة طلب GET

الخطوة 1 - إنشاء حساب Postman

قم بإنشاء حساب Postman جديد (فقط إذا لم يكن لديك واحد) وابدأ تحميل تطبيق Postman على جهازك. التطبيق يوفر ميزات أكثر من نسخته على الويب.

الخطوة 2 - إنشاء طلب API جديد على Postman

بمجرد تثبيت Postman، قم بإنشاء طلب جديد من خلال النقر على زر جديد في الزاوية العلوية اليسرى من نافذة Postman. اختر طلب HTTP لإنشاء طلب جديد، كما هو موضح في الصورة أعلاه.

الخطوة 3 - أدخل طريقة API والتفاصيل

بعد ذلك، تحتاج إلى تضمين تفاصيل طلب API الذي ترغب في إنشائه. يجب أن تتضمن مكونات مثل عنوان URL، طرق HTTP، والمعلمات الإضافية التي سيتطلبها API.

الخطوة 4 - افتح قسم نص سكريبت ما قبل الطلب

على طلبك المكتمل، ابحث عن قسم نص سكريبت ما قبل الطلب، كما هو موضح في الصورة أعلاه.

الخطوة 5 - أدخل الكود الضروري لتضمين التاريخ

تحت علامة نص سكريبت ما قبل الطلب، أضف الأسطر التالية من الكود حتى تتمكن من تضمين التاريخ الحالي.

var moment = require('moment');

pm.environment.set('currentdate', moment().format(("YYYY-MM-DD HH:MM:SS")));

في هذا المثال الخاص، سيتم تخزين الطابع الزمني في متغير currentdate باستخدام طريقة pm.environment.set.

الخطوة 6 - تضمين متغير currentdate كمتغير طلب

أضف متغير currentdate إلى قسم معلمات الاستعلام في طلب GET الخاص بك حتى تتمكن من ملاحظة التاريخ الحالي في كل مرة ترسل فيها طلبًا.

Apidog - تخصيص APIs

إذا كنت تبحث عن منصة تطوير API قوية، اعتبر Apidog بديلاً عن Postman. يقوم Apidog بتبسيط العملية من خلال التعامل مع العديد من التفاصيل المعقدة من أجلك. اغطس في الأقسام التالية لاستكشاف كيف يساعدك Apidog في تصور هذه التفاصيل الخاصة بـ API!

تضمين التاريخ الحالي في رؤوس الطلب في Apidog

لتضمين الطابع الزمني الحالي في رأس طلب API، اتبع الخطوات أدناه!

يمكن استخدام مقتطف الكود التالي لدمج التاريخ الحالي في رأس طلب API. ببساطة، انسخ والصق هذه الأسطر في نص مخصص داخل قسم نصوص ما قبل الطلب (المسمى سابقًا بالمعالجات المسبقة) كما هو موضح في الصورة.

var timestamp = new Date().getTime();
pm.environment.set("timestamp", timestamp);

بمجرد أن قمت بتهيئة متغير الطابع الزمني، تأكد من إضافة المتغير كمعلمة استعلام. انظر الصورة أعلاه للمرجع.

عرض التاريخ والمزيد في طلب API في Apidog

يتجاوز Apidog الطوابع الزمنية الأساسية. يوفر تفاصيل عميقة عن API، بما في ذلك الكعكات وأشكال الطلب الخام. يمنحك هذا العرض الشامل القدرة على تحديد المشكلات وتحسين APIs الخاصة بك من أجل نشر سلس. بالإضافة إلى ذلك، ضع في اعتبارك اختبار تحميل API لتقييم قوة API لديك.

في الختام، استكشفت هذه المقالة طريقتين فعالتين لدمج التاريخ الحالي كقيمة طلب GET ضمن Postman: نصوص ما قبل الطلب ومتغيرات البيئة. توفر نصوص ما قبل الطلب مرونة للتلاعب الديناميكي، بينما توفر متغيرات البيئة إمكانية إعادة الاستخدام عبر الطلبات. من خلال الاستفادة من هذه التقنيات، يمكنك بناء طلبات GET قابلة للتكيف وديناميكية تحاكي السيناريوهات الواقعية وتعزز فعالية اختبار وتطوير API لديك.

علاوة على ذلك، فإن القدرة على تضمين عناصر ديناميكية مثل التاريخ الحالي تؤكد قوة Postman كأداة لتطوير API. هذا يمكنك من إنشاء حالات اختبار أكثر قوة وواقعية، مما يؤدي في النهاية إلى نشر APIs مجهزة للتعامل مع مجموعة أوسع من الشروط.