Postman či Insomnia: tímové API testy menia správnu voľbu

Pre samostatného vývojára alebo tím, ktorý chce ukladať definície a testy lokálne či vo vlastnom Gite, je vhodnejšia Insomnia: prehľad Insomnie od Kongu opisuje otvoreného desktopového klienta s prácou bez pripojenia. Postman dáva väčší zmysel tímu, ktorý chce prepájať zmluvnú validáciu, testy v CI, záťažové skúšky a kontroly po nasadení; tieto možnosti uvádza porovnanie od Postmanu.

Oba nástroje vedia posielať požiadavky, spúšťať kolekcie a podporujú Git. Rozhoduje spôsob, akým tím spravuje projektové dáta, udržiava súlad testov so špecifikáciou a sleduje API po vydaní. Pre malý tím môže byť dôležitejšia kontrola nad repozitárom; pre tím s viacerými rolami môže mať väčšiu hodnotu spoločný pracovný priestor a nadväzujúce kontroly.

Kde zostanú definície, kolekcie a testy

Insomnia umožňuje vybrať úložisko podľa projektu. Možnosti ukladania v Insomnii rozlišujú Local Vault s dátami v zariadení, Git Sync s repozitárom zvoleným používateľom a Cloud Sync so synchronizáciou cez službu Insomnia. Pri Git Sync prechádzajú projektové dáta medzi zariadením a zvoleným Git repozitárom. Každý spolupracovník si však musí vytvoriť vlastný projekt a pripojiť ho k spoločnému repozitáru.

Git Sync preto dobre zapadá do tímu, ktorý už posudzuje zmeny cez vetvy a požiadavky na začlenenie kódu. Vývojár si môže ponechať projekt lokálne a synchronizovať ho až podľa zvoleného postupu. Cloud Sync je pohodlnejší, ak členovia tímu potrebujú spoločný projekt bez nastavovania Git pripojenia na každom zariadení. Samotný výber úložiska nie je trvalý: typ projektu sa dá zmeniť, no prechod z Gitu na cloud preruší synchronizáciu nových zmien s pôvodným repozitárom.

Git už nie je výlučnou prednosťou Insomnie. Postman podporuje ukladanie kolekcií a špecifikácií do Gitu aj miestnu prácu s projektovými súbormi. Rozdiel je preto presnejšie formulovať ako voľbu pracovného postupu: Insomnia stavia voľbu úložiska priamo do projektu, zatiaľ čo širšie funkcie Postmanu počítajú aj so zdieľaním v jeho pracovnom priestore. Pri citlivých údajoch treba osobitne posúdiť projektové súbory, hodnoty prostredia a tajomstvá; uloženie kolekcie v Gite samo osebe nechráni prihlasovacie údaje, ktoré by sa do nej dostali.

Čo zvládnu testy v CI a zmluvná validácia

Insomnia postačí aj na automatizované funkčné testy. Jej Inso CLI dokáže spúšťať kolekcie a kontrolovať špecifikácie v CI; testy napísané pri požiadavkách sa tak môžu vykonať pri zmene kódu. Tím, ktorý už má vlastný repozitár a výsledok potrebuje najmä na schválenie alebo zastavenie zostavenia, nemusí kvôli samotnej automatizácii prejsť na ďalšiu platformu.

Postman získava význam, keď tím potrebuje udržiavať testovacie kolekcie vo väzbe na zmluvu API. Jeho pracovný postup prepája špecifikáciu s kolekciou a umožňuje odhaliť ich rozchod; zmluvná validácia potom kontroluje očakávaný tvar rozhrania. To je odlišná úloha od tvrdenia, že odpoveď jednej požiadavky má správny stavový kód. Aj Insomnia podporuje validáciu schémy a kontrolu OpenAPI špecifikácie, no testovacie tvrdenia a zmeny zmluvy si tím musí priebežne zosúlaďovať.

Pri dokumentácii záleží na tom, kto ju používa. Ak vývojári udržiavajú opis API spolu so špecifikáciou v repozitári, Git postup dáva zmenám jasnú históriu. Ak majú tie isté rozhrania používať aj testeri, správcovia produktu alebo partneri, spoločný pracovný priestor Postmanu môže uľahčiť prístup ku kolekciám a ich opisu. Výhodu však prináša len udržiavaný obsah a vhodne nastavené prístupové práva.

Kedy rozhoduje záťažové testovanie

Ak treba zistiť správanie API pri súbežných požiadavkách, Postman ponúka zabudované výkonové testy nad kolekciou. Návod na výkonové testy Postmanu opisuje virtuálnych používateľov, nastavenie priebehu záťaže a spustenie z desktopovej aplikácie alebo cez CLI v CI. Lokálny beh je dostupný vo všetkých plánoch; beh v infraštruktúre Postmanu vyžaduje platený plán.

Lokálny výkonový test využíva prostriedky počítača alebo prostredia CI, ktoré ho spúšťa. Dosiahnuteľná záťaž preto závisí aj od stroja a obsahu kolekcie, nie iba od testovaného API. Pri rozhodovaní je dôležité, či tím potrebuje záťažový test ako súčasť existujúcej kolekcie, alebo už má samostatný nástroj a postup na výkonové skúšky. V druhom prípade širšia ponuka Postmanu nemusí priniesť ďalšiu hodnotu.

Čo sa kontroluje po nasadení

Test v CI ukáže stav pri konkrétnej zmene; monitor sleduje vybrané požiadavky aj neskôr. Dokumentácia monitorov Postmanu opisuje plánované spúšťanie kolekcií alebo špecifikácií, upozornenia pri zlyhaní a možnosť spustiť monitor cez CLI. Tím tak môže nadviazať na testovacie požiadavky pravidelnou kontrolou dostupnosti a odpovedí API.

Umiestnenie monitoru mení rozhodnutie pri interných a citlivých rozhraniach. Bežný monitor sa vykonáva v Postman Cloud a nemá prístup k hodnotám uloženým iba v Postman Local Vault. Súkromné spúšťače v internej sieti sú dostupné v pláne Enterprise; výsledky aj pri nich smerujú do cloudu Postmanu. Ak pravidlá organizácie takýto tok údajov neumožňujú, lokálne spúšťané kontroly v CI môžu byť vhodnejšie, hoci samy nenahrádzajú plánované sledovanie prevádzky.

Rozhodovacia matica podľa spôsobu práce

• Samostatný vývojár: Insomnia je vhodná, ak sú prioritou projektové dáta v zariadení, práca bez pripojenia a vlastný Git. Postman môže byť výhodnejší, ak už individuálny projekt vyžaduje zabudované záťažové testy alebo plánovaný monitor.
• Malý tím: Insomnia dáva zmysel, ak tím posudzuje API artefakty v repozitári, spúšťa kolekcie v CI a prevádzkový dohľad rieši samostatne. Postman je presvedčivejší, ak majú špecifikácia, testy, dokumentácia a monitoring tvoriť spoločný pracovný postup pre viac rolí.
• Regulované firemné prostredie: Voľba závisí od povoleného umiestnenia projektových dát, tajomstiev a výsledkov behov. Insomnia umožňuje ponechať projekt lokálne alebo v zvolenom Gite. Postman ponúka širšie nadväzujúce kontroly, no pri monitorovaní interného API treba zohľadniť plán, miesto vykonania testu a tok výsledkov.

Prečítajte si aj:

• Google Forms či Microsoft Forms: nové limity menia voľbu pri veľkých zberoch
• Slovenská či európska ochranná známka: expanzia môže zmeniť správnu voľbu
• Pandektes získal 13,5 mil. eur: právne dáta chce otvoriť cez API