API’ni testlash: integratsiyani ishga tushirishdan oldin nimani tekshirish

API testlash — API to‘g‘ri, xavfsiz va barqaror ishlashini tekshirish. Bu ham API ishlab chiquvchi, ham uning bilan integratsiya quradigan tomon uchun kerak. Ko‘p integratsiya muammolari asosiy ssenariy emas, kutilmagan holatlar tufayli yuzaga keladi.

Muvaffaqiyatli ssenariylar

Avval hujjatda tasvirlangan har bir metod hujjatga mos ishlashini tekshiring:

• so‘rov to‘g‘ri formatda qabul qilinadi;
• javob tuzilmasi va maydonlar hujjatdagidek;
• ma’lumot haqiqatan yaratiladi, o‘zgaradi yoki o‘chiriladi;
• holat kodlari to‘g‘ri: yaratishda 201, o‘qishda 200.

Xato ssenariylar

• Majburiy maydon yo‘q
• Noto‘g‘ri tur: raqam o‘rniga matn, noto‘g‘ri sana formati
• Mavjud bo‘lmagan obyekt — 404 qaytadimi
• Takroriy yaratish — ikki marta bir xil buyurtma yaratilib qolmaydimi
• Juda uzun qatorlar, maxsus belgilar, kirill va lotin aralash matn
• Manfiy va nol qiymatlar summa va miqdorda

Har bir xatoda API tushunarli xabar qaytarishi va ma’lumotlarni buzmasligi kerak.

Avtorizatsiya va ruxsatlar

• Kalitsiz so‘rov rad etiladimi
• Muddati o‘tgan token rad etiladimi
• Bir mijoz boshqa mijoz ma’lumotlarini identifikatorni o‘zgartirib ola olmaydimi
• Faqat o‘qish ruxsatli kalit bilan yozib bo‘lmaydimi

Ruxsatlarni tekshirish — xavfsizlik testlarining eng muhim qismi.

Chegaraviy holatlar

• Bo‘sh ro‘yxatlar va sahifalash: birinchi, oxirgi, mavjud bo‘lmagan sahifa
• Katta hajmdagi javoblar
• Vaqt zonalari va sana chegaralari: oy oxiri, yil almashishi
• Bir vaqtda bir obyektni ikki so‘rov o‘zgartirsa nima bo‘ladi

Ishlash tezligi va yuklama

• Odatiy yuklamada javob vaqti
• Eng ko‘p kutilgan yuklamada barqarorlik
• So‘rovlar chegarasi oshganda API 429 qaytaradimi va mijoz buni to‘g‘ri qayta ishlaydimi

Vebhuklar

Agar API hodisalar haqida vebhuk yuborsa:

• vebhuk keladimi va formati to‘g‘rimi;
• imzo tekshiriladimi;
• sizning serveringiz ishlamay qolsa, qayta yuboriladimi;
• takroriy vebhuk ikki marta qayta ishlanmaydimi.

Vositalar

• Postman, Insomnia va shunga o‘xshash dasturlar — qo‘lda so‘rovlar va to‘plamlar
• curl — buyruq qatoridan tez tekshiruv
• Avtomatik testlar — dasturlash tilidagi test freymvorklari
• Yuklama testlari uchun maxsus vositalar
• OpenAPI tavsifi asosida testlarni avtomatik yaratish

Sinov muhiti

Testlar ishchi tizimda emas, sinov muhitida o‘tkaziladi — ayniqsa to‘lovlar va mijozlarga xabar yuboradigan API’lar uchun. Ko‘p servislar alohida sinov (sandbox) muhitini beradi. Sinov ma’lumotlari ishchi ma’lumotlarga o‘xshash, lekin haqiqiy shaxsiy ma’lumotlarsiz bo‘lsin.

Asosiy ssenariylar uchun avtomatik testlar har bir o‘zgarishdan keyin ishga tushirilsin. Shunda yangi funksiya eski integratsiyani buzganini dasturchi foydalanuvchidan oldin biladi.

Integratsiyani qabul qilishda

Pudratchidan testlar ro‘yxati va natijalarini so‘rang. Kamida: barcha metodlarning muvaffaqiyatli ssenariysi, asosiy xato holatlari, ruxsatlar tekshiruvi va takroriy so‘rovlardan himoya. Bu ro‘yxat keyinchalik yangilashlarda ham ishlatiladi.