شارك المقالة
Postman Scripts: استخراج token والتحقق من استجابة API

Postman Scripts: استخراج token والتحقق من استجابة API

Postman Scripts تساعدك على اختبار استجابة API واستخراج token بعد التحقق من نجاح الطلب، مع استخدام البيئة الصحيحة وحماية القيم…

Postman Scripts تساعدك على اختبار استجابة API واستخراج token بعد التحقق من نجاح الطلب، مع استخدام البيئة الصحيحة وحماية القيم الحساسة.

اختر مكان السكربت

Pre-request يعمل قبل إرسال الطلب، بينما Post-response يستخدم لفحص النتيجة وتشغيل الاختبارات. أسماء التبويبات قد تختلف بين نسخ Postman. اختر Environment الصحيح قبل التشغيل، ولا تضع token في Globals لمجرد أن بيئة لم تُحدد؛ قد يسبب ذلك استخدام جلسة مختلفة داخل مجموعة أخرى.

لا تفترض شكل الاستجابة

تحقق من رمز HTTP ثم من إمكانية قراءة JSON ومسار الحقل ونوعه. الاستجابة الفاشلة قد تكون HTML أو JSON ببنية أخرى. المثال يفترض واجهة اختبار تعيد data.token ويزيل القيمة القديمة عند الفشل حتى لا يوهمك نجاح طلب لاحق باستخدام جلسة سابقة.

حماية الأسرار

لا تطبع token في Console ولا تحفظه في أمثلة عامة أو ملفات مصدرة إلى Git. استخدم Postman Vault أو آلية الأسرار المتاحة في إصدارك عند الملاءمة، وراجع ما تتم مشاركته أو مزامنته فعليًا مع الفريق. مدة صلاحية token وrefresh وإبطاله جزء من تصميم API وليس وظيفة سكربت الاستخراج وحده.

مثال للتطبيق

pm.environment.unset('token');
let token;
try {
  if (pm.response.code >= 200 && pm.response.code < 300) {
    token = pm.response.json()?.data?.token;
  }
} catch (_) { /* Not a JSON response. */ }
pm.test('Response contains a usable token', function () {
  pm.expect(typeof token === 'string' && token.trim().length > 0).to.eql(true);
});
if (typeof token === 'string' && token.trim().length > 0) {
  pm.environment.set('token', token);
}

المرجع الرسمي

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

الصور والفيديو من الشرح السابق

الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.

لا تكتب الكود من الصفر بعد اليوم! Snippets في Postman ستحول طريقتك في العمل
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع