[Postman] تمرير الطابع الزمني الحالي في طلب Postman

عند إنشاء سجلات بيانات جديدة أو تعديل بيانات موجودة في الجزء الخلفي، يمكن أن يكون تمرير الطابع الزمني الحالي أحد المكونات المهمة التي يجب توافرها. لحسن الحظ، يمتلك Postman، وهو أداة API، الميزات اللازمة لتوفير الطوابع الزمنية في الطلبات.

تتناول هذه المقالة طريقتين فعالتين لتضمين الطابع الزمني الحالي ضمن طلباتك في Postman: استخدام المتغير الزمني المحدد مسبقًا واستغلال قوة السكربتات قبل الطلب.

ما هو Postman؟

بالنسبة للمطورين، يعتبر Postman أداة شائعة وموثوقة لتطوير API. إنه يمكّنهم ليس فقط من إنشاء واختبار APIs ولكن أيضًا من توثيقها. من خلال تبسيط عملية تطوير API بالكامل، يجعل Postman عالم APIs المعقد غالبًا أكثر سهولة وفهمًا.

ما هو الطابع الزمني الحالي؟

الطابع الزمني الحالي يشير إلى تمثيل الوقت الدقيق الذي يحدث فيه حدث ما. هناك بعض الصيغ التي يمكن أن يعبر عنها الطابع الزمني:

Unix TImestamp (الز秒 منذ بداية الزمن)

يمثل هذا التنسيق عدد الثواني المنقضية منذ نقطة معينة في الزمن، عادةً 1 يناير 1970، 00:00:00 UTC. إنه يوفر تنسيقًا مضغوطًا وسهل القراءة للآلات لـ APIs.

تنسيق ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ):

هذا التنسيق القياسي يعبر عن التاريخ والوقت بطريقة قابلة للقراءة من قبل البشر وقابلة للمعالجة بواسطة الآلات. يشمل السنة، الشهر، اليوم، الساعة، الدقيقة، الثانية، المللي ثانية (اختياري)، ومؤشر المنطقة الزمنية (Z لـ UTC). هذا التنسيق يسهل التواصل الواضح ويتجنب الارتباك عبر الأنظمة المختلفة.

أهمية الطوابع الزمنية في APIs

• الدقة والترتيب: إنها تحدد الوقت الدقيق الذي وقع فيه حدث ما ضمن تفاعل API. هذا يساعد في تتبع أوقات إنشاء البيانات أو تعديلها، مما يضمن تسلسلًا دقيقًا ويمنع الارتباك حول متى حدثت الأشياء.
• حديثة البيانات: يمكن أن تشير الطوابع الزمنية إلى مدى حداثة البيانات. هذا أمر حاسم في السيناريوهات التي تتعلق بمعلومات الوقت الحقيقي أو البيانات ذات الحياة المحدودة. تخيل واجهة برمجة تطبيقات أسعار الأسهم - معرفة الطابع الزمني يساعد على تحديد ما إذا كانت السعر تعكس حالة السوق الحالية.
• تحديد الأخطاء: يمكن أن تساعد الطوابع الزمنية في استكشاف الأخطاء وإصلاحها. من خلال مقارنة الطوابع الزمنية في الطلب والاستجابة، يمكن للمطورين تحديد التأخيرات المحتملة أو تحديد مكان حدوث المشكلات في تدفق الاتصال.
• التحكم في الإصدار والتدقيق: يمكن استخدام الطوابع الزمنية لتتبع تغييرات إصدار API أو تسجيل نشاط المستخدم. هذا يسهل التراجع إلى الإصدارات السابقة إذا لزم الأمر ويساعد في الحفاظ على سجل استخدام API لأغراض التدقيق.

دليل خطوة بخطوة حول كيفية تمرير الطابع الزمني الحالي في طلب API الخاص بـ Postman

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

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

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

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

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

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

الخطوة 4 - فتح قسم Pre-Request Script

في API المكتمل الخاص بك، ابحث عن قسم Pre-request script، كما هو موضح في الصورة أعلاه.

الخطوة 5 - إدخال الكود اللازم لتضمين الطابع الزمني

في هذا القسم الفارغ تحت علامة تبويب Pre-request Script، أدخل الأسطر التالية من الكود حتى تتمكن من تضمين الطابع الزمني.

var moment = require('moment');

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

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

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

أخيرًا، تأكد من تضمين المتغير الزمني في API عن طريق إعداد معلمة API. الآن، في كل مرة ترسل فيها طلبًا إلى هذا API بالتحديد، يجب أن تكون قادرًا على العثور على الطابع الزمني عند إرسال الطلب!

Apidog - توفير أدق التفاصيل بشكل افتراضي

Apidog هو منصة شاملة لتطوير API يمكن أن تكون بديلاً ممتازًا عن Postman. مع Apidog، لم تعد بحاجة للقلق بشأن التفاصيل الصغيرة - فقد تم حساب جميعها بواسطة Apidog - لذا ألقِ نظرة على الأقسام أدناه لرؤية كيفية عرض تفاصيل هذه API!

تضمين الطابع الزمني في رؤوس الطلبات في Apidog

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

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

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

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

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

مع Apidog، يمكنك العثور على أكثر من مجرد الطابع الزمني الآلي، يمكنك أيضًا عرض تفاصيل أخرى تتعلق بـ API، مثل الكوكيز وتنسيق الطلب الخام. مع Apidog، يمكنك استكشاف أخطاء APIs بدقة لضمان أن APIs الخاصة بك جاهزة للنشر.

يمكنك أيضًا التفكير في القيام بـ اختبار تحميل API لاستكشاف API الخاص بك بشكل أعمق لضمان أنها خالية من الأخطاء!

الخاتمة

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

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