عند العمل مع الـ APIs، فإن فهم طول استجاباتك يمكن أن يكون جانبًا حاسمًا. هذا صحيح بشكل خاص عند التعامل مع كميات كبيرة من البيانات. Postman، أداة شائعة الاستخدام في اختبار APIs، توفر وسيلة للتحقق من طول استجاباتك.
في هذه المقالة، سنرشدك خلال عملية فحص طول الاستجابة في Postman. هذا الدليل مناسب لجميع مستويات الخبرة، من المبتدئين إلى المطورين ذوي الخبرة. لنبدأ ونتعلم كيفية استخدام هذه الميزة في عملية اختبار API الخاصة بك.
ما هو Postman؟
Postman هو عميل API يسهل على المطورين إنشاء ومشاركة واختبار وتوثيق APIs. يتم ذلك من خلال السماح للمستخدمين بإنشاء وحفظ طلبات HTTP/s بسيطة ومعقدة، بالإضافة إلى قراءة استجاباتهم.
لماذا تتحقق من طول الاستجابة؟
الآن، قد تتساءل، "لماذا يجب أن أتحقق من طول الاستجابة؟" حسنًا، يمكن أن يعطيك طول الاستجابة فكرة عن كمية البيانات التي تم إرجاعها بواسطة API الخاصة بك. يمكن أن يكون هذا حاسمًا لاختبار الأداء والتحسين.
التحقق من طول استجابة Postman
حسناً، دعنا نبدأ بالموضوع. إليك دليل خطوة بخطوة حول كيفية التحقق من طول استجابة Postman:
إرسال طلب: أولاً، تحتاج إلى إرسال طلب إلى API الخاصة بك. يمكنك القيام بذلك عن طريق إدخال نقطة النهاية الخاصة بـ API في حقل URL الطلب والضغط على زر "إرسال".

تحقق من الاستجابة: بمجرد أن تقوم بإرسال الطلب، سيعرض Postman الاستجابة في القسم السفلي من واجهة الاستخدام.

تحقق من الرؤوس: في قسم رؤوس الاستجابة، ابحث عن رأس يسمى "Content-Length". هذا الرأس يشير إلى طول جسم الاستجابة.

إذا لم يكن رأس "Content-Length" موجودًا، يمكنك حساب الطول يدويًا. فقط قم بنسخ جسم الاستجابة والصقه في محرر نصوص يعرض عدد الأحرف.
كيفية حساب مفاتيح الاستجابة في Postman
أولاً، تحتاج إلى إضافة عنوان URL الخاص بطلبك ثم الانتقال إلى تبويب الاختبارات وإضافة قطعة كود لحساب عدد المفاتيح في JSON الاستجابة. إليك ما يفعله:
const responseJson = pm.response.json(); // هذه السطر يحصل على الاستجابة من API Postman ويحللها كـ JSON.
var count = Object.keys(responseJson).length; // هذه السطر يحسب عدد المفاتيح في كائن JSON الذي تم تحليله.
console.log("عدد المفاتيح المتوقعة في جسم الاستجابة هو: " + count); // هذه السطر يسجل العدد في وحدة التحكم.
أرسل طلبًا إلى API الخاصة بك

سيؤدي ذلك إلى طباعة عدد المفاتيح في جسم الاستجابة إلى وحدة التحكم.

وهناك لديك! أنت الآن تعرف كيف تتحقق من طول مفاتيح استجابة Postman.
كيفية حساب طول الاستجابة في بناء الجملة الجديد في Apidog
Apidog هو منصة تكامل تعاونية مصممة لتبسيط عملية تطوير API. تجمع بين وظائف عدة أدوات مثل Postman وSwagger وMock وJMeter في منصة واحدة.
إرسال طلب: أولاً، تحتاج إلى إرسال طلب إلى API الخاصة بك. يمكنك القيام بذلك عن طريق إدخال نقطة النهاية الخاصة بـ API في حقل URL الطلب والضغط على زر "إرسال".

تحقق من الاستجابة: بمجرد أن تقوم بإرسال الطلب، سيعرض Apidog الاستجابة في القسم السفلي من واجهة الاستخدام.

تحقق من الرؤوس: في قسم رؤوس الاستجابة، ابحث عن رأس يسمى "Content-Length". هذا الرأس يشير إلى طول جسم الاستجابة.

احسب الطول: إذا لم يكن رأس "Content-Length" موجودًا، يمكنك حساب الطول يدويًا. فقط قم بنسخ جسم الاستجابة والصقه في محرر نصوص يعرض عدد الأحرف مثل Notepad++.

الآن، دعنا نعتبر سيناريو حيث يحتوي كائن على خاصيتين: type (enum) وvalues (array). عندما يكون قيمة type هي fixed، يجب أن يكون طول values هو 1؛ وعندما تكون قيمة type هي range، يجب أن يكون طول values هو 2؛ وعندما تكون قيمة type هي other، لا يوجد حد لطول values.
للحصول على حد لطول values بناءً على قيمة type في Apidog، يمكنك تعريف أنواع مختلفة من بيانات المحاكاة.
عد مفاتيح الاستجابة في Apidog
في Apidog، يمكنك التحقق من هيكل استجابة API وحساب المفاتيح في جسم الاستجابة. كل ما عليك فعله هو كتابة نص برمجي لتحليل الاستجابة وحساب المفاتيح.
var responseJson = /* استجابة API الخاصة بك هنا */;
var count = Object.keys(responseJson).length;
console.log("عدد المفاتيح في جسم الاستجابة هو: " + count);
إذا كنت تعمل مع استجابات JSON. افتح Apidog وانتقل إلى تبويب معالجة ما بعد المعالجة.

اختر إضافة معالجات ما بعد المعالجة ثم نص مخصص.

هذه النص البرمجي يحصل على الاستجابة، ويحللها كـ JSON، ويحسب عدد المفاتيح في كائن JSON الذي تم تحليله، ويسجل العدد في وحدة التحكم.

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