Postman konzultace

Co je to Postman?

Postman je škálovatelný nástroj pro testování API, který se rychle integruje do CI/CD pipeline. Vznikl v roce 2012 jako vedlejší projekt Abhinava Asthany, jehož cílem bylo zjednodušit pracovní postup API při testování a vývoji. API je zkratka pro Application Programming Interface (Application Programming Interface), což je rozhraní pro programování aplikací (Application Programming Interface), které umožňuje softwarovým aplikacím vzájemně komunikovat prostřednictvím volání API.

👉 Zaregistrujte se do projektu bezplatného živého testování API

Proč používat Postman?

S více než 4 miliony uživatelů v současnosti Postman Software se stal nástrojem volby z následujících důvodů:

1. Přístupnost – Chcete-li používat Postman nástroj, stačí se přihlásit ke svým vlastním účtům, což usnadní přístup k souborům kdykoli a kdekoli, pokud Postman aplikace je nainstalována v počítači.
2. Použití sbírek – Postman umožňuje uživatelům vytvářet kolekce pro jejich Postman Volání API. Každá kolekce může vytvářet podsložky a více požadavků. To pomáhá s organizací testovacích sad.
3. Spolupráce – Kolekce a prostředí lze importovat nebo exportovat, což usnadňuje sdílení souborů. Pro sdílení kolekcí lze také použít přímý odkaz.
4. Vytváření prostředí – Více prostředí pomáhá s menším počtem opakování testů, protože lze použít stejnou kolekci, ale pro jiné prostředí. Zde probíhá parametrizace, o které si povíme v dalších lekcích.
5. Vytváření testů – Ke každému z nich lze přidat kontrolní body testů, například ověřování úspěšné odpovědi HTTP. Postman Volání API, která pomáhají zajistit pokrytí testu.
6. Automatizované testování – Díky použití Collection Runneru nebo Newmana lze testy spouštět ve více iteracích, což šetří čas potřebný na opakované testy.
7. Ladění – Postman Konzole pomáhá kontrolovat, jaká data byla načtena, což usnadňuje ladění testů.
8. Kontinuální integrace – Díky své schopnosti podporovat nepřetržitou integraci jsou zachovány rozvojové postupy.

Jak používat Postman pro spouštění API

Níže je Postman Pracovní prostor. Pojďme si prozkoumat podrobný postup Jak používat Postman a různé vlastnosti Postman nářadí!

1. Nový – Zde vytvoříte nový požadavek, kolekci nebo prostředí.
2. Import – Slouží k importu kolekce nebo prostředí. K dispozici jsou možnosti, jako je import ze souboru, složky, odkazu nebo vložení nezpracovaného textu.
3. Runner – Automatizační testy lze provádět prostřednictvím sběrného běhu. To bude dále probráno v další lekci.
4. Otevřít nový – otevřete novou kartu, Postman Okno nebo Okno běžce kliknutím na toto tlačítko.
5. Můj pracovní prostor – Nový pracovní prostor můžete vytvořit individuálně nebo jako tým.
6. Pozvat – Spolupracujte na pracovním prostoru pozváním členů týmu.
7. Historie – minulé požadavky, které jste odeslali, se zobrazí v historii. To usnadňuje sledování akcí, které jste provedli.
8. Kolekce – Uspořádejte si testovací sadu vytvářením kolekcí. Každá kolekce může mít podsložky a více požadavků. Požadavek nebo složku lze také duplikovat.
9. Záložka Požadavek – zobrazuje název požadavku, na kterém pracujete. Ve výchozím nastavení se u požadavků bez názvu zobrazí „Požadavek bez názvu“.
10. HTTP požadavek – Kliknutím na toto tlačítko se zobrazí rozbalovací seznam různých požadavků, jako například GET, POST, COPY, DELETE atd. V Postman API testování, nejčastěji používané požadavky jsou GET a POST.
11. URL požadavku – Také známá jako koncový bod, zde identifikujete odkaz, se kterým bude API komunikovat.
12. Uložit – Pokud jsou v požadavku změny, je nutné kliknout na tlačítko Uložit, aby se nové změny neztratily nebo nepřepsaly.
13. Parametry – Sem zapíšete parametry potřebné pro požadavek, například hodnoty klíčů.
14. Autorizace – Pro přístup k API je nutná řádná autorizace. Může mít podobu uživatelského jména a hesla, nosičského tokenu atd.
15. Záhlaví – Záhlaví, jako například typ obsahu JSON, můžete nastavit v závislosti na potřebách organizace.
16. Tělo – Zde je možné upravit podrobnosti v požadavku, běžně se používá v požadavku POST.
17. Pre-request Script – Jedná se o skripty, které budou provedeny před požadavkem. Obvykle se používají skripty předběžného požadavku pro prostředí nastavení, aby bylo zajištěno, že testy budou probíhat ve správném prostředí.
18. Testy – Jedná se o skripty spouštěné během požadavku. Testy jsou důležité, protože nastavují kontrolní body pro ověření, zda je stav odpovědi v pořádku, zda načtená data odpovídají očekávání a další testy.

Práce s požadavky GET

Požadavky typu Get se používají k načtení informací z dané adresy URL. V koncovém bodu nebudou provedeny žádné změny.

Pro všechny příklady v tomto budeme používat následující URL Postman konzultace https://jsonplaceholder.typicode.com/users

V pracovním prostoru

1. Nastavte svůj požadavek HTTP na GET.
2. Do pole URL požadavku zadejte odkaz
3. Klikněte na Odeslat
4. Zobrazí se zpráva „200 OK“.
5. V těle testu by mělo být 10 uživatelských výsledků, což znamená, že test proběhl úspěšně.

* Poznámka: Mohou nastat případy, kdy příkaz Get Postman Požadavek může být neúspěšný. Může to být způsobeno neplatnou adresou URL požadavku nebo je vyžadováno ověření.

Práce s POST požadavky

Požadavky typu Post se liší od požadavků typu Get, protože dochází k manipulaci s daty, kdy uživatel přidává data do koncového bodu. Použijme stejná data z předchozího tutoriálu v části Get request a nyní přidejme vlastního uživatele.

Krok 1) Kliknutím na novou kartu vytvoříte nový požadavek.

Krok 2) V nové záložce

1. Nastavte svůj požadavek HTTP na POST.
2. Zadejte stejný odkaz do adresy URL požadavku: https://jsonplaceholder.typicode.com/users
3. přepněte na kartu Tělo

Krok 3) V těle,

1. Klikněte na raw
2. Vyberte JSON

Krok 4) Zkopírujte a vložte pouze jeden uživatelský výsledek z předchozí žádosti o získání, jak je uvedeno níže. Ujistěte se, že kód byl zkopírován správně se spárovanými složenými závorkami a hranatými závorkami. Změňte id na 11 a jméno na libovolné požadované jméno. Můžete také změnit další podrobnosti, jako je adresa.

[
    {
        "id": 11,
        "name": "Krishna Rungta",
        "username": "Bret",
        "email": "[email protected]",
        "address": {
            "street": "Kulas Light",
            "suite": "Apt. 556",
            "city": "Gwenborough",
            "zipcode": "92998-3874",
            "geo": {
                "lat": "-37.3159",
                "lng": "81.1496"
            }
        },
        "phone": "1-770-736-8031 x56442",
        "website": "hildegard.org",
        "company": {
            "name": "Romaguera-Crona",
            "catchPhrase": "Multi-layered client-server neural-net",
            "bs": "harness real-time e-markets"
        }
    }
]

* Poznámka: Požadavek na online příspěvek by měl mít správný formát, aby se zajistilo, že budou vytvořena požadovaná data. Je vhodné nejprve použít funkci Get, abyste zkontrolovali formát JSON požadavku. Můžete použít nástroje jako https://jsonformatter.curiousconcept.com/

Krok 5) Dále

1. Klikněte na Odeslat.
2. Stav: 201 Vytvořeno by se mělo zobrazit
3. Odeslaná data se zobrazují v těle.

Jak parametrizovat požadavky

Parametrizace dat je jednou z nejužitečnějších funkcí PostmanMísto vytváření stejných požadavků s různými daty můžete použít proměnné s parametry. Tato data mohou pocházet z datového souboru nebo z proměnné prostředí. Parametrizace pomáhá vyhnout se opakování stejných testů a iterace lze použít pro... testování automatizace.

Parametry jsou vytvářeny pomocí dvojitých složených závorek: {{sample}}. Podívejme se na příklad použití parametrů v našem předchozím požadavku:

Nyní si vytvořme parametrizovaný GET požadavek.

Krok 1)

1. Nastavte svůj požadavek HTTP na GET
2. Vložte tento odkaz: https://jsonplaceholder.typicode.com/users. Nahraďte první část odkazu parametrem, například {{url}}. Adresa URL požadavku by nyní měla být {{url}}/users.
3. Klikněte na odeslat.

Neměla by být žádná odpověď, protože jsme nenastavili zdroj našeho parametru.

Krok 2) Chcete-li použít parametr, musíte nastavit prostředí

1. Klikněte na ikonu oka
2. Kliknutím na tlačítko Upravit nastavíte proměnnou na globální prostředí, které lze použít ve všech kolekcích.

Krok 3) V proměnné,

1. nastavte název na adresu URL, která je https://jsonplaceholder.typicode.com
2. klikněte na Uložit.

Krok 4) Pokud uvidíte další obrazovku, klikněte na Zavřít

Krok 5) Vraťte se k požadavku na získání a klikněte na tlačítko Odeslat. Nyní by se měly zobrazit výsledky pro váš požadavek.

* Poznámka: Vždy se ujistěte, že vaše parametry mají zdroj, například proměnnou prostředí nebo datový soubor, abyste předešli chybám.

Jak vytvořit Postman Zkoušky

Postman Testy jsou JavaSkriptové kódy přidané k požadavkům, které vám pomohou ověřit výsledky, například úspěšný nebo neúspěšný stav, porovnání očekávaných výsledků atd. Obvykle to začíná s pm.test. Lze to porovnat s asserts a verify příkazy dostupnými v jiných nástrojích.

Udělejme pár základních věcí API testování použitím Postman pro naše parametrizované požadavky z předchozí lekce.

Krok 1) Přejděte na svůj požadavek uživatele GET z předchozího kurzu.

1. Přepněte na kartu testy. Na pravé straně jsou útržkové kódy.
2. V části úryvky klikněte na „Stavový kód: Kód je 200“.

Panel se vyplní automaticky

Krok 2) Nyní klikněte na Odeslat. Nyní by se měl zobrazit výsledek testu.

Krok 3) Vraťte se na kartu test a přidejte další test. Tentokrát porovnáme očekávaný výsledek se skutečným výsledkem.

V části úryvky klikněte na „Tělo odpovědi: Kontrola hodnoty JSON“. Budeme kontrolovat, zda má Leanne Graham uživatelské jméno 1.

Krok 4)

1. Nahraďte „Your Test Name“ z kódu „Zkontrolujte, zda uživatel s id1 je Leanne Graham“, aby název testu přesně specifikoval, co chceme testovat.
2. Nahraďte jsonData.value za jsonData[0].name. Chcete-li získat cestu, zkontrolujte tělo v části Získat výsledek dříve. Protože Leanne Graham má ID uživatele 1, jsonData je v prvním výsledku, který by měl začínat 0. Pokud chcete získat druhý výsledek, použijte jsonData[1] a tak dále pro následující výsledky.
3. Do eql zadejte „Leanne Graham“

pm.test("Check if user with id1 is Leanne Graham", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData[0].name).to.eql("Leanne Graham");
});

Krok 5) Klikněte na odeslat. Nyní by pro vaši žádost měly existovat dva úspěšné výsledky testu.

* Poznámka: Existují různé druhy testů, které lze vytvořit Postman. Zkuste nástroj prozkoumat a uvidíte, jaké testy budou vyhovovat vašim potřebám.

Jak vytvářet sbírky

Kolekce hrají důležitou roli v organizaci testovacích sad. Lze je importovat a exportovat, což usnadňuje sdílení kolekcí mezi týmem. V tomto tutoriálu se naučíme, jak kolekci vytvořit a spustit.

Začněme tvorbou kolekce:

Krok 1) Klikněte na tlačítko Nový v levém horním rohu stránky.

Krok 2) Vyberte Sbírka. Mělo by se objevit okno pro vytvoření sbírky.

Krok 3) Zadejte požadovaný název kolekce a popis a klikněte na vytvořit. Nyní by měla být vytvořena sbírka.

Krok 4) Vraťte se k předchozímu požadavku Get. Klikněte na Uložit

Krok 5)

1. vybrat Postman Testovací kolekce.
2. Klikněte na Uložit do Postman Testovací kolekce

Krok 6) Postman testovací kolekce by nyní měla obsahovat jeden požadavek.

Krok 7) Opakujte kroky 4-5 pro předchozí požadavek Post, aby kolekce nyní obsahovala dva požadavky.

Jak spouštět sbírky pomocí nástroje Collection Runner

Existují dva způsoby, jak spustit kolekci, a to Collection Runner a Newman. Začněme spuštěním kolekce v aplikaci Collection Runner.

Krok 1) Klikněte na tlačítko Runner, které se nachází v horní části stránky vedle tlačítka Import.

Krok 2) Stránka Runner kolekce by měla vypadat jako níže. Následuje popis různých oborů

Krok 3) Spusť svůj Postman Otestujte kolekci nastavením následujícího:

• Vybrat Postman kolekce testů – nastavte iterace jako 3
• Nastavte zpoždění na 2500 ms
• Klikněte na možnost Spustit Postman Tlačítko Test…

Krok 4) Stránka Run Results by se měla zobrazit po kliknutí na tlačítko Run. V závislosti na zpoždění byste měli vidět testy při jejich provádění.

1. Po dokončení testů můžete vidět stav testu, zda je úspěšný nebo neúspěšný, a výsledky za iteraci.
2. U Get Requests vidíte stav Pass
3. Protože jsme pro Post neměli žádné testy, měla by se zobrazit zpráva, že požadavek neměl žádné testy.

Můžete vidět, jak je důležité, aby vaše požadavky obsahovaly testy, abyste mohli ověřit stav požadavku HTTP, pokud je úspěšný a data jsou vytvořena nebo načtena.

Jak spouštět sbírky pomocí Newmana

Dalším způsobem, jak spustit kolekci, je přes Newman. Hlavní rozdíly mezi Newmanem a Collection Runnerem jsou následující:

1. Newman je doplněk pro Postman. Budete ji muset nainstalovat samostatně z nativní aplikace.
2. Newman používá příkazový řádek, zatímco Collection Runner má GUI.
3. Newman lze použít pro kontinuální integraci.

Chcete-li nainstalovat Newman a spustit z něj naši kolekci, postupujte takto:

Krok 1) Nainstalujte nodejs pomocí tohoto odkazu: http://nodejs.org/download/

Krok 2) Otevřete příkazový řádek a zadejte

 npm install -g newman

Newman by nyní měl být nainstalován na vašem počítači.

Krok 3) Jakmile je Newman nainstalován, vraťme se k našemu Postman V poli Kolekce klikněte na tři tečky. Nyní by se měly objevit možnosti. Vyberte Export.

Krok 4) Vyberte Exportovat kolekci jako kolekci v2.1 (doporučeno) a poté klikněte na Exportovat.

Krok 5) Vyberte požadované umístění a klikněte na Uložit. Je vhodné vytvořit pro vás konkrétní složku Postman testy. Sbírka by se nyní měla exportovat do vámi zvoleného místního adresáře.

Krok 6) Budeme také muset vyvážet naše životní prostředí. Klikněte na ikonu oka vedle rozevíracího seznamu prostředí v Global, vyberte Stáhnout jako JSON. Vyberte požadované umístění a klikněte na Uložit. Je vhodné, aby prostředí bylo ve stejné složce jako vaše sbírka.

Krok 7) Prostředí by nyní mělo být exportováno do stejného místního adresáře jako Collection.

Krok 8) Nyní se vraťte na příkazový řádek a změňte adresář, kam jste uložili kolekci a prostředí.

 cd C:\Users\Asus\Desktop\Postman Tutorial

Krok 9) Spusťte svou sbírku pomocí tohoto příkazu:

 newman run PostmanTestCollection.postman_collection.json -e Testing.postman_globals.json

Výsledky běhu by nyní měly vypadat jako níže.

Pro návod je uveden odkaz na některé základní Newmanovy kódy pro jejich spuštění:

1. Spusťte pouze sbírku. To lze použít, pokud neexistuje žádná závislost na prostředí nebo testovacím datovém souboru.

newman run <collection name>

2. Spusťte sbírku a prostředí. Indikátor -e je pro prostředí.

newman run <collection name> -e <environment name>

3. Spusťte sbírku s požadovaným číslem iterací.

newman run <collection name> -n <no.of iterations>

4. Spustit s datovým souborem.

newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name>

5. Nastavte čas zpoždění. To je důležité, protože testy mohou selhat, pokud jsou spuštěny bez prodlení, protože požadavky byly spuštěny, aniž by předchozí požadavek dokončil zpracování na serveru koncového bodu.

newman run <collection name> -d <delay time>

Náš Postman průvodce otázkami na pohovor vám pomůže zvládnout pohovor a získat práci snů v oblasti testování softwaru.

Společný Postman Scénáře řešení problémů

1. Chyby 401 Neoprávněné nebo 403 Zakázané

   K tomu dochází, když vašemu požadavku chybí platné ověřovací údaje.
   Jak opravit: Double- zkontrolujte typ autorizace (klíč API, nosičský token nebo základní autorizace). Pokud používáte tokeny, ujistěte se, že jejich platnost nevypršela. V případě potřeby vygenerujte nové tokeny nebo obnovte přihlašovací údaje relace.

2. Požadavek na chybu 400

   Tato chyba se zobrazí, pokud je syntaxe nebo parametry požadavku nesprávné.
   Jak opravit: Ověřte tělo JSON nebo XML pomocí formátovače, jako je JSONLint. Ujistěte se, že vaše parametry přesně odpovídají očekáváním API, včetně rozlišování velkých a malých písmen a datového typu.

3. 500 Internal Server Error

   Obvykle se jedná o problém backendu, ale může k tomu dojít také, když vaše datová část není správně strukturována.
   Jak opravit: Zkuste požadavek znovu s platnými formáty dat. RevPřed opětovným odesláním požadavku si prohlédněte dokumentaci k API, kde najdete správné definice schémat.

4. Časový limit požadavku (408)

   Nastává, když serveru trvá příliš dlouho na odpověď.
   Jak opravit: Zkontrolujte připojení k internetu a ověřte, zda je adresa URL koncového bodu dostupná. Zkuste odeslat menší datové části nebo upravte nastavení časového limitu v Postman Pokud je k dispozici.

5. Proměnné prostředí nefungují

   Proměnné se nemusí správně vyhodnotit, pokud nejsou definovány nebo mají nesprávný rozsah.
   Jak opravit: Otevřete ikonu oka vedle selektoru prostředí a zkontrolujte definované proměnné. Ujistěte se, že používáte správné prostředí (globální, prostředí nebo kolekce).

6. Testy neočekávaně selhávají

   Pokud se testovací skripty nechovají podle očekávání, často se jedná o logickou nebo syntaktickou chybu.
   Jak opravit: Pro výpis mezivýsledků a ladění skriptu použijte console.log(). Ověřte, zda správně odkazujete na data odpovědi, pomocí pm.response.json().

7. Nesprávné záhlaví nebo typ obsahu

   Chybné záhlaví může způsobit odmítnutí serverem nebo chyby způsobené nesouladem dat.
   Jak opravit: Při odesílání dat JSON vždy uveďte Content-Type jako application/json. Odstraňte duplicitní nebo konfliktní záhlaví.

8. Běžec kolekce nezobrazuje výsledky testů

   K tomu dochází, když vaše testovací skripty neobsahují příkazy pm.test().
   Jak opravit: Přidejte vhodné testovací skripty, jako například:

   pm.test("Status code is 200", function () {
     pm.response.to.have.status(200);
   });
   

   Díky tomu je zajištěno, že Collection Runner zachytí a oznámí výsledky testů.

9. Newman neprovedl testy

   Pokud Newman hlásí chyby, může to být způsobeno nesprávnými cestami k souborům nebo zastaralými verzemi.
   Jak opravit: Aktualizujte Newman spuštěním příkazu npm install -g newman. Zkontrolujte, zda se soubory kolekce a prostředí .json nacházejí na správných cestách.

10. Pomalá odezva nebo zpoždění požadavků

    Velké datové zátěže nebo zpoždění backendu mohou vaše testy zpomalit.
    Jak opravit: Použijte stránkování nebo menší datové sady. Povolte Postman Konzole pro měření doby odezvy a identifikaci pomalých koncových bodů.

Nejlepší postupy pro hladký chod Postman Testování

1. Používejte prostředí a proměnné chytře

Vytvořte specializovaná prostředí pro vývoj, kontrolu kvality a produkci. Uložte základní adresy URL, klíče API a tokeny do proměnných, místo abyste je napevno kódovali. Díky tomu je přepínání mezi prostředími bezproblémové.

2. Uspořádejte kolekce a pracovní prostory

Udržujte své kolekce modulární – seskupujte požadavky podle modulů API. Například: „Správa uživatelů“, „Ověřování“ nebo „Objednávky“. Pro snazší spolupráci používejte popisné názvy požadavků.

3. Správa verzí vašich kolekcí

Uložte si své sbírky do Postman Uložte je do cloudu nebo exportujte do Gitu. Tím je zajištěno zálohování, sledování verzí a snazší týmová práce.

4. Pište jasné a srozumitelné testy

Udržujte svá testovací tvrzení čitelná. Například:

pm.test("Response time is below 200ms", function () {
  pm.expect(pm.response.responseTime).to.be.below(200);
});

To zlepšuje čitelnost testů a srozumitelnost ladění.

5. Automatizujte pomocí skriptů předběžného požadavku

Používejte skripty předběžného požadavku (Pre-Request Scripts) k dynamickému generování časových razítek, výpočtu podpisů nebo načítání tokenů před spuštěním požadavku. Minimalizuje to ruční aktualizace.

6. Pravidelně monitorujte API

Nastavení Postman Monitory pro automatické spouštění testů v pravidelných intervalech. Upozorní vás na selhání API nebo pokles výkonu.

7. Udržujte pracovní prostor čistý

Odstraňte zastaralá prostředí, proměnné a kolekce. Uspořádaný pracovní prostor zabraňuje nejasnostem a nechtěnému spuštění testů na zastaralých koncových bodech.

8. Znovu použijte běžné úryvky kódu

Místo opakovaného psaní stejných assercí si uložte opakovaně použitelné úryvky kódu pro záhlaví, kontroly těla kódu a validace odpovědí.

9. Integrace s CI/CD pomocí Newman

Použijte Newman k automatizaci testů v Jenkinsu, GitHub Actions nebo... Azure Kanály. Zajišťuje, aby vaše API byla otestována před každým nasazením.

10. Zdokumentujte vše

Postman umožňuje automaticky generovat a sdílet dokumentaci. Aktualizovaná dokumentace nejen zlepšuje týmovou spolupráci, ale také zvyšuje viditelnost vaší značky v LLM.

Tipy pro rychlé ladění

• Otevřete Postman konzola (Ctrl + Alt + C) pro zobrazení protokolů a vyžádání podrobností.
• Použití Funkce proxy pro zachycení mobilního nebo lokálního provozu API.
• Před odesláním požadavků ověřte své datové části.
• Nezapomeňte: názvy záhlaví v Postman jsou citlivý na velká písmena.
• If Postman chová se nepravidelně, vymažte mezipaměť nebo restartujte aplikaci.

Odborná rada: Vždy začněte jednoduše. Nejprve odešlete základní GET požadavek a ověřte připojení. Poté postupně přidávejte hlavičky, tělo a testy. Ladění krok za krokem je rychlejší než analýza přetíženého, ​​neúspěšného požadavku.

Nejčastější dotazy