الـ API يردّ. هل يردّ بما يجب؟
تطبيق الجوال والمتجر وشركاؤك كلهم يعتمدون على الـ API، وأي تغيير صغير فيه يكسرهم دون أن يظهر على أي شاشة. ارفع ملف الوصف، فيقرأ مهندس الجودة العمليات ويقترح الاختبارات، ثم ينفّذها ويريك أي طلب أعاد غير المتوقّع، ومعه الطلب والردّ كما هما.
أخطاء الـ API لا تظهر على الشاشة
حقل تغيّر اسمه، فتعطّل التطبيق
تعديل بسيط في الردّ يبدو بريئاً في الكود، ثم يتوقّف تطبيق الجوال عن عرض الطلبات. ولا أحد ينتبه حتى يشتكي العملاء.
مستخدم يرى بيانات غيره
الطلب ينجح ويعيد بيانات، لكنها بيانات عميل آخر. اختبار «هل يردّ؟» لا يكشف هذا. يكشفه اختبار «هل يردّ بما يحقّ لهذا المستخدم؟».
الفحص اليدوي لا يتكرّر
يجرّب المطوّر بضعة طلبات بيده قبل الإصدار وينتهي الأمر. في الإصدار التالي لا أحد يعيدها كلها، فيعود خلل قديم.
من ملف الوصف إلى اختبارات تراجعها
ارفع ملف وصف الـ API أو الصقه، بصيغة OpenAPI أو Swagger، مكتوباً بـ JSON أو YAML. يقرأ مهندس الجودة العمليات ويقترح لكل واحدة ما يستحق التحقّق: هل الحالة صحيحة، هل الحقول المطلوبة موجودة وبالنوع الصحيح، هل تُرفض البيانات الناقصة برسالة مفهومة، وهل يُمنع مستخدم من قراءة بيانات غيره. وحين تسمح بالكتابة يجرّب تسلسلاً كاملاً: ينشئ سجلاً، ثم يقرؤه، ثم يحذفه.
- الحالة والحقول وأنواعها
- الصلاحيات ورسائل الخطأ
- إنشاء ثم قراءة ثم حذف، بإذنك
اختبارات تُكتب مرة وتُعاد مع كل إصدار
كل اختبار يُحفظ حالةً بخطوات مقروءة: الطلب الذي يُرسل وما يُتوقّع في الردّ. تجمعها في مجموعات، وتعدّلها بنفسك متى تغيّر الـ API، وتشغّلها كلها بضغطة بعد كل إصدار. وتاريخ كل حالة أمامك: متى نجحت ومتى فشلت.
- خطوات مقروءة، لا كود تصونه
- مجموعات تشغّلها بضغطة
- تاريخ النجاح والفشل لكل حالة
الطلب والردّ كما هما، بلا أسرار
حين يفشل اختبار لا يصلك «فشل» فقط. تصلك بطاقة خلل فيها الطلب الذي أُرسل، والردّ الذي عاد، وما كان متوقّعاً، وأثره على من يستخدم الـ API. مفاتيح الدخول والرموز وكلمات المرور تُحجب قبل أن يُحفظ أي دليل، فتشارك البطاقة مع مطوّرك مطمئناً.
- الطلب والردّ مرفقان بكل خلل
- المفاتيح والرموز محجوبة
- يُغلق بعد نجاح إعادة الاختبار
ما تقوله، وما يتحقّق منه مهندس الجودة
API الطلبات في متجر
ينشئ طلب اختبار، ثم يقرؤه ويتحقّق من الإجمالي والحالة، ثم يحذفه. ويجرّب إنشاء طلب بلا عنوان ليتأكّد من أنه يُرفض برسالة واضحة.
تأكّد أن إنشاء الطلب وقراءته وإلغاءه تعمل، وأن الطلب الناقص يُرفض برسالة يفهمها المطوّر.
بيانات كل عميل له وحده
بحسابَي اختبار يحاول أن يقرأ بالأول فواتير الثاني. الصحيح أن يُرفض الطلب، وإن عادت البيانات فهذا خلل بخطورة عالية.
تحقّق أن العميل لا يستطيع أن يرى فواتير عميل آخر، حتى لو غيّر الرقم في الطلب.
قبل إصدار جديد لتطبيق الجوال
يعيد تشغيل مجموعة الاختبارات المحفوظة على الـ API الذي يعتمد عليه التطبيق، ويقارن النتيجة بالجولة السابقة: ما الجديد وما الذي عاد.
أعد كل اختبارات الـ API وقل لي هل انكسر شيء كان يعمل في الإصدار الماضي.
كيف تختبر الـ API في خمس خطوات
من ملف الوصف إلى مجموعة اختبارات تعيدها متى شئت.
- 1
أضف عنوان الـ API
من «مهندس الجودة» اختر «اختبر API» واكتب عنوانه. بإضافته تؤكّد أنه لك أو أن لك إذناً باختباره، ويصير جاهزاً مباشرة.
- 2
ارفع ملف الوصف
ارفع ملف OpenAPI أو Swagger أو الصقه، بصيغة JSON أو YAML. منه يعرف مهندس الجودة العمليات المتاحة وما يُفترض أن تعيده.
- 3
أضف مفتاح اختبار وحدّد المسموح
أضف مفتاح دخول خاصاً بالاختبار، ويُحفظ مشفّراً. ثم قرّر: قراءة فقط، أم يُسمح بإنشاء سجلات اختبار وحذفها.
- 4
راجع الاختبارات المقترحة
يعرض مهندس الجودة الحالات مجمّعة مع أولوية كل منها، وينبّهك إلى ما ينشئ بيانات. أطفئ ما لا تريده، ثم شغّل.
- 5
اقرأ النتيجة وأعدها بعد كل إصدار
كل اختبار فاشل بطاقة فيها الطلب والردّ. بعد الإصلاح أعد الاختبار، واحتفظ بالمجموعة لتشغّلها مع كل إصدار جديد.
بصراحة: ما الذي يجب أن تعرفه
أسئلة تتكرّر
ما هو اختبار الـ API؟
كيف أختبر API دون كتابة كود؟
ما صيغ ملفات الوصف التي يقبلها فنّان؟
هل يختبر صلاحيات الـ API؟
هل مفاتيح الـ API آمنة عند الاختبار؟
هل يقوم فنّان باختبار الضغط على الـ API؟
هل اختبار الـ API في فنّان مجاني؟
ماذا يختبر لك مهندس الجودة أيضاً؟
مهندس الجودة
الصفحة الرئيسية: مهندس جودة بالذكاء الاصطناعي يخطّط الاختبارات، وينفّذها في متصفح حقيقي، ويوثّق كل خلل بالدليل، ويخبرك هل تطبيقك جاهز للإطلاق.
تعرّف على مهندس الجودةاختبار المواقع
موقعك مبنيّ خارج فنّان؟ أضف رابطه واطلب من مهندس الجودة اختبار صفحاته ونماذجه ومساراته في متصفح حقيقي.
اقرأ التفاصيلالاختبار بعد كل تعديل
كل حالة اختبار تُحفظ وتُعاد. بعد أي تعديل تعرف في دقائق هل ما كان يعمل ما زال يعمل، ومتى انكسر.
اقرأ التفاصيلتتبّع الأخطاء
كل خلل بطاقة فيها الأثر والخطوات والمتوقّع والفعلي ولقطة الشاشة، وتبقى مفتوحة حتى تثبت إعادة الاختبار أنه أُصلح.
اقرأ التفاصيلاختبر قبل النشر
تطبيقك مبنيّ بفنّان؟ اختبره من نافذة النشر نفسها، واطلب من فنّان إصلاح ما ظهر، ثم انشر وأنت تعرف حالته.
اقرأ التفاصيلللمطاعم وأنظمة الحجز
ضيفان، طاولة واحدة، الساعة السابعة مساءً: كيف يكتشف مهندس الجودة الحجز المزدوج قبل أن يكتشفه ضيوفك.
اقرأ التفاصيلأدلة تقرؤها قبل أن تختبر
ما هو اختبار البرمجيات؟
شرح لصاحب المشروع، بلا مصطلحات: ما الذي يُختبر، وأنواع الاختبار التي تهمّك فعلاً، ومتى يكفي الاختبار اليدوي ومتى لا يكفي.
اقرأ الدليلقائمة فحص الموقع قبل الإطلاق
قائمة عملية تمرّ عليها قبل أن تعلن عن موقعك: التسجيل، والنماذج، والدفع، والجوال، والعربية، والرسائل، وما بعد الإطلاق.
اقرأ الدليلكيف تكتب تقرير خلل
قالب جاهز وأمثلة: عنوان واضح، وخطوات تعيد الخلل، والمتوقّع مقابل الفعلي، والدليل، وكيف تحدّد الخطورة دون مبالغة.
اقرأ الدليلاعرف أن الـ API سليم قبل أن يخبرك تطبيقك.
ارفع ملف الوصف، وراجع الاختبارات المقترحة، وشغّلها بعد كل إصدار. مهندس الجودة ضمن الخطط المدفوعة، والتسجيل مجاني.