Bevezető
Képzeld el, hogy egy étteremben vagy, és rendelsz egy pizzát. Az étterem konyhája olyan, mint egy API – te csak leadod a rendelést (kérés), és várod az ételt (válasz). De mi van, ha más információkat is megadnánk? Pl: Ételallergia, más köret, stb. Honnan tudjuk, hogy mikor kell ezeket jelezni, egyáltalán mi az ami „opció”, lehetőség ebben az étteremben? Vagy mi van, ha a szakács félreértelmezi az „extra sajt” kérésed, és egy sajttenger érkezik? Körülbelül ezen kérdéseket kell feltennünk, ha API tesztelést tervezünk.
Miért szeretnénk erről cikksorozatot készíteni?
Ha valaha is rákerestél az „API tesztelés” kifejezésre, valószínűleg találkoztál már olyan cikkekkel, amik rögtön a mély vízbe dobnak: „Íme egy komplex Python script a JWT token kezelésére!” vagy „REST vs SOAP API tesztelés különbségei mikroszerviz architektúrában”. Hűha! De mi van akkor, ha csak azt szeretnéd tudni, hogyan kezdj neki az egésznek tesztelői szemmel?
Ez a cikksorozat pont erről fog szólni. Nem programozói szemszögből közelítjük meg a témát, hanem kifejezetten tesztelői perspektívából.
Témák, amiket fel szeretnénk dolgozni
Kérdezni tudni kell!
Emlékszel még az éttermes példára? Mielőtt nekiállnánk tesztelni egy API-t, ugyanúgy kérdéseket kell feltennünk, mint egy pincérnek: „Mi van, ha gluténérzékeny vagyok?”, „Mennyi idő alatt készül el?”, „Mi történik, ha nem jó a rendelés?”. Az első témáink között végigvesszük, hogy hogyan tudjuk meg, milyen kérdéseket tehetünk fel?
Dokumentáció – a tesztelő legjobb barátja (vagy ellensége?)
Mi a különbség egy jó és egy rossz API dokumentáció között? Olyan ez, mint amikor összehasonlítasz egy részletes IKEA útmutatót egy kézzel firkált cetlivel. Nemsokára megnézzük, minek kell szerepelnie egy API dokumentációban, és mit kezdj vele tesztelőként.
Teszteset tervezés – A tesztelők csodafegyvere!
„De hát ez csak egy API, mi baj lehet?” – gondolhatod. Nos, ugyanaz, mint amikor random összedobálsz hozzávalókat egy receptben. Azt is megnézzük majd, hogyan tervezz API teszteket úgy, hogy ne maradjon ki semmi fontos.
Amikor minden elromlik – hibakezelés tesztelése
Mi történik, ha rossz címre küldöd a pizzarendelést? Vagy ha 100 pepperonit kérsz -5 sajt mellett? Az API-knak fel kell készülniük a furcsa és hibás kérésekre is. Erről is beszélnünk kell majd, hogy, hogyan teszteld a hibakezelést, a határeseteket, és hogyan győződj meg arról, hogy az API értelmesen reagál a képtelen kérésekre is.
Verziókezelés – amikor változik a menü
Képzeld el, hogy kedvenc éttermed megújítja a menüt. A régi rendelők még a régi menüből választanak, az újak már az újból. Ugyanez történik az API-kkal is! API tesztelőként tudnod kell, hogyan teszteld az API különböző verzióit, és mit jelent a visszafelé kompatibilitás a gyakorlatban.
Integrációs tesztelés – amikor összeáll a nagy kép
Egy modern étteremben a rendelés útja hosszú: a pincér tabletjétől, a konyhai kijelzőn át, egészen a házhozszállító app-ig. Az API-k világában is gyakran több rendszer működik együtt. Az integrációs tesztelés API esetében sok szempont figyelembevételét igényli. A tervünk az, hogy bemutatjuk majd, hogy mire figyelj, amikor több API együttműködését vizsgálod.
Struktúra és szervezés
Képzeld el, hogy a konyhai receptjeid mind egy nagy kupacban hevernek. Káosz, ugye? Ugyanez igaz az API tesztekre is. Megmutatjuk majd, hogyan tartsd rendben a tesztjeidet úgy, hogy később is megtalálj mindent.
Tippek, trükkök és haladó témák
Vagy a részeken belül, vagy külön részként, de tervezünk megosztani néhány olyan praktikát, amit a tapasztalt API tesztelők már megtanultak – néha a nehezebb úton. 🙂
Kinek fog szólni ez a sorozat?
- Azoknak a tesztelőknek, akik most ismerkednek az API teszteléssel
- Azoknak, akik már teszteltek API-t, de szeretnének rendszerezettebb tudást
- És igen, még a fejlesztőknek is, akik szeretnék megérteni, mire figyelnek a tesztelők
Mi NEM lesz a sorozatban?
Békaemberek. Ezek biztosan nem lesznek ebben a sorozatban. Ami még nem várható:
Nem fogunk beleveszni a végtelen technikai részletekbe. Nem lesz szó arról, hogyan írj komplett keretrendszert nulláról, és nem fogunk órákat tölteni azzal, hogy különböző programozási nyelvekben mutassuk meg ugyanazt. Ehelyett tesztelés-szakmai részekre koncentrálunk: hogyan teszteld hatékonyan és értelmesen az API-kat.
Szóval, ha szeretnéd megtudni, hogyan lehet az API tesztelést átgondoltan, érthetően, strukturáltan csinálni, tarts velünk a következő részekben!
Addig is:
Jó tesztet! Hajrá!
