كيفية إنشاء طابع زمني متغير ديناميكي في Postman

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

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

فهم واجهات برمجة التطبيقات وPostman

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

قوة المتغيرات الديناميكية

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

الطوابع الزمنية بالميلي ثانية: لماذا نحتاج إليها؟

تعتبر الطوابع الزمنية متطلبًا شائعًا في العديد من واجهات برمجة التطبيقات. يمكن استخدامها لأغراض متنوعة، مثل:

الدقة: غالبًا ما تتعامل واجهات برمجة التطبيقات مع أحداث يجب تسجيلها بدقة عالية. الدقة بمستوى الميلي ثانية أمر بالغ الأهمية لتتبع تسلسل الأحداث بدقة، خاصة في الأنظمة ذات التردد العالي.

التوحيد القياسي: يساعد استخدام تنسيق موحد مثل الطوابع الزمنية لنظام Unix بالميلي ثانية في ضمان الاتساق عبر الأنظمة المختلفة. هذا أمر مهم بشكل خاص عندما تستخدم عدة عملاء نفس النقاط النهائية.

الكفاءة: نظرًا لأن الأعداد الصحيحة أسهل في الاستعلام والفهرسة وأكثر كفاءة من حيث المساحة من السلاسل النصية، عادة ما يتم تخزين التواريخ كأعداد صحيحة 64 بت مثل زمن Unix مع الميلي ثانية.

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

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

إنشاء الطوابع الزمنية الديناميكية في Postman

يمكن إنشاء طابع زمني ديناميكي في Postman باستخدام ميزة نص ما قبل الطلب. إليك طريقتين يمكنك استخدامهما:

الطريقة 1: استخدام كائن التاريخ في JavaScript:

يمكنك استخدام كائن التاريخ في JavaScript لإنشاء طابع زمني وتخزينه في متغير. إليك كيفية القيام بذلك:

const dateNow = new Date();
pm.environment.set('currentDate', dateNow.toISOString());

ثم، يمكنك استخدامه في جسم الطلب كما يلي:

"currentDate": "{{currentDate}}"

الطريقة 2: استخدام moment.js

إذا كنت بحاجة إلى مزيد من التحكم في تنسيق الطابع الزمني، يمكنك استخدام مكتبة moment.js. إليك مثال:

const moment = require('moment');
pm.globals.set("today", moment().format("MM/DD/YYYY"));

ثم، يمكنك الإشارة إلى {{today}} كلما احتجت إليها في طلبك.

تذكر، يجب إضافة هذه النصوص في علامة نص ما قبل الطلب في Postman. إذا قمت بإضافة هذه إلى مستوى مجموعة نص ما قبل الطلب، فسيتم تشغيلها لكل طلب في المجموعة.

كيفية إنشاء الطوابع الزمنية الديناميكية في Apidog

Apidog هي منصة تعاونية متكاملة لتوثيق واجهات برمجة التطبيقات، وتصحيح واجهات برمجة التطبيقات، ومحاكاة واجهات برمجة التطبيقات، واختبار واجهات برمجة التطبيقات الآلي. إنها تجمع بين وظائف Postman وSwagger وMock وJMeter لمعالجة مشكلة مزامنة البيانات بين الأنظمة المختلفة باستخدام مجموعة من الأنظمة ومجموعة من البيانات.

في Apidog، المتغيرات الديناميكية هي قيم معلمة يتم إنشاؤها تلقائيًا وفقًا لقواعد نظام محددة مسبقًا أثناء تشغيل واجهة برمجة التطبيقات. إنشاء طابع زمني ديناميكي في Apidog أمر بسيط. إليك كيفية القيام بذلك:

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

انقر للبدء في تعيين المتغيرات الديناميكية.

اختر نوع القيمة الديناميكية التي تريد إضافتها.

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

يمكنك أيضًا إنشاء طوابع زمنية ديناميكية في Apidog باستخدام نفس الطرق التي تستخدمها في Postman.

مع كائن تاريخ JavaScript:

يمكنك استخدام كائن تاريخ JavaScript لإنشاء طابع زمني وتخزينه في متغير. إليك كيفية القيام بذلك:

const dateNow = new Date();
pm.environment.set('currentDate', dateNow.toISOString());

ثم، يمكنك استخدامه في جسم الطلب كما يلي:

"currentDate": "{{currentDate}}"

مع moment.js

إذا كنت بحاجة إلى مزيد من التحكم في تنسيق الطابع الزمني، يمكنك استخدام مكتبة moment.js. إليك مثال:

const moment = require('moment');
pm.globals.set("today", moment().format("MM/DD/YYYY"));

ثم، يمكنك الإشارة إلى {{today}} كلما احتجت إليها في طلبك.

تذكر، يجب إضافة هذه النصوص في علامة نص ما قبل الطلب في Postman. إذا قمت بإضافة هذه إلى مستوى مجموعة نص ما قبل الطلب، فسيتم تشغيلها لكل طلب في المجموعة.

تحسين اختبارات واجهة برمجة التطبيقات الخاصة بك مع الطوابع الزمنية الديناميكية

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

الخاتمة

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

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