كيف تختبر واجهات REST API في VS Code
في هذه الصفحة 7 قسم
الإجابة المختصرة: ثبّت إضافة عميل REST، وافتحها بجوار شيفرتك، وأرسل الطلبات من هناك. يستخدم هذا الدليل REST API Client المجاني في DevSnip Pro: دون حساب، ومع البيئات والمجموعات واستيراد cURL وتوليد الشيفرة. والعادات التي يصفها تصلح مع أي عميل.

التنقل بين محررك وأداة API منفصلة يكلّف أكثر مما يبدو: تنسخ عنوان URL من الشيفرة، وتلصق رمزًا من ملف .، وترسل، ثم تنسخ JSON عائدًا لتكتب نوعًا أو اختبارًا. أما داخل VS Code، فتبقى الشيفرة والطلب والاستجابة متجاورة.
- شغّل DevSnip Pro: REST API Client من لوحة الأوامر (Ctrl/Cmd+Shift+P)، أو انقره في الشريط الجانبي لـ DevSnip Pro.
- انقر Send a sample request. يرسل
GET https:/، وهي واجهة اختبار عامة مجانية./ jsonplaceholder. typicode. com/ todos/ 1 - تعرض لوحة الاستجابة الحالة والوقت والحجم، وJSON منسقًا قابلًا للبحث، والترويسات وملفات تعريف الارتباط.
لواجهتك أنت، اكتب عنوان URL واضغط Enter. وإذا كان الطلب لديك بالفعل كأمر cURL (أدوات المطوّر في المتصفح: Copy as cURL)، فالصقه في شريط العنوان: تُستورد الطريقة والترويسات والجسم.
أنشئ بيئة لكل هدف، مثل local وstaging، فيها متغيرات مثل baseUrl وtoken. ثم اكتب الطلبات هكذا:
GET {{baseUrl}}/users/42
Authorization: Bearer {{token}}يعيد تبديل البيئة تشغيل الطلب نفسه على خادم آخر، وتبقى الأسرار خارج الطلب الذي تحفظه.
احفظ الطلبات في مجموعات، مقسّمة إلى مجلدات تعكس بنية واجهتك (auth/ وusers/ وbilling/). ويحتفظ السجل بكل ما أرسلته، مع إخفاء قيم عناوين URL التي تبدو كبيانات اعتماد. وتصبح الطلبات المحفوظة وثائق حية لمن ينضم إلى المشروع بعدك.
استجابة 200 بجسم خاطئ تبقى خطأً. لكل نقطة نهاية تلمسها، افحص:
- الشكل: هل الحقول موجودة، وبالأنواع المتوقعة، ومسمّاة باتساق؟
- المدخلات الخاطئة: يجب أن يُرجع غياب حقل مطلوب أو حقل بنوع خاطئ رمز
4xxواضحًا، لا500مع تتبّع للمكدس. - المصادقة: رمز منتهي الصلاحية أو مفقود. يوقّع JWT Decoder & Signer رمز اختبار بقيمة
expفي الماضي. - الموارد غير الموجودة:
404برسالة مفيدة. - الترويسات:
Content-Type، وترويسات التخزين المؤقت، وترويسات CORS إن كان المتصفح سيستدعيها (يشرح CORS Builder & Debugger أخطاء CORS). - الوقت: نقطة النهاية التي تستغرق 900 مللي ثانية محليًا لن تكون أسرع في الإنتاج.
وحين تفحص الحقل نفسه للمرة الثالثة، حوّله إلى تأكيد يعمل مع كل إرسال، أو سلسِل الطلبات (تسجيل الدخول ← الإنشاء ← التحقق)، أو شغّل دفعة لترى نسب زمن الاستجابة المئوية. تُدفع هذه الأدوات المتقدمة بالنقاط التي تكسبها باستخدام الإضافة؛ لا يوجد ما تشتريه.
حين ينجح الطلب، ولّد الشيفرة الخاصة به بـ JavaScript (fetch أو Axios) أو Python أو Go أو Java أو C#، أو صدّره بصيغة cURL لملف README أو تقرير خطأ. وللحصول على أنواع من الاستجابة، افتح JSON to Types من الشريط الجانبي Tools: TypeScript أو Zod أو Pydantic أو Kotlin أو Swift أو Dart أو Java أو Go أو JSON Schema.
تعمل انطلاقًا من مواصفات؟ يفحصها OpenAPI / Swagger Toolkit، ويعرض كل نقطة نهاية، ويولّد أنواع TypeScript وعميل fetch وأوامر cURL.
- افتح Database Client للتأكد من الصف الذي كتبه طلبك. راجع كيف تتصل بـ PostgreSQL وMySQL وMongoDB وRedis في VS Code.
- شغّل DevSnip Pro: Endpoint Security Scan على عنوان URL مصرّح لك باختباره: TLS وHSTS وترويسات الأمان وCSP وCORS وملفات تعريف الارتباط، مع إصلاح لكل منها. راجع كيف تعثر على الأسرار المكتوبة في الشيفرة ومشكلات الأمان في VS Code.
| الخطوة | لماذا تهم |
|---|---|
| البيئات | طلب واحد وخوادم كثيرة؛ ولا أسرار في الطلبات المحفوظة |
| المجموعات | فحوصات قابلة للتكرار ومعرفة مشتركة |
| مسارات الفشل | تلتقط أخطاء العقود ومعالجة الأخطاء |
| الشيفرة والأنواع | لا نسخ يدوي لعناوين URL وJSON |
| فحص الأمان | إصلاح الترويسات سيئة الإعداد رخيص قبل الإصدار |