Přejít na hlavní obsah

Jak vytvořit sbírku v Postman

Postman je výkonná aplikace pro testování API, která vývojářům umožňuje pracovat s API v pohodlném a intuitivním prostředí. Jednou z hlavních funkcí Postmana je vytváření a správa sbírek, které vám umožňují seskupovat a organizovat požadavky API ve vhodném formátu.

Chcete-li začít s kolekcemi v Postman, musíte přejít na kartu "Collections" v levém podokně aplikace. Poté kliknutím na tlačítko "Create a Collection" vytvoříte novou kolekci. Při vytváření kolekce budete vyzváni k zadání názvu a popisu sbírky, abyste ji v budoucnu snáze identifikovali.

Po vytvoření sbírky můžete do ní přidat požadavky na API. Chcete-li to provést, klikněte na tlačítko "Create a Request" a zadejte adresu URL vašeho dotazu, metodu a další možnosti. Po vytvoření dotazu jej budete moci přidat do sbírky, kterou si vyberete, výběrem z rozevíracího seznamu. Pokud potřebujete přidat další požadavky, jednoduše opakujte proces vytváření a přidávání dotazu API do sbírky.

Sbírky v Postman mohou také obsahovat proměnné, které vám umožňují měnit hodnoty v dotazech za běhu. Proměnné můžete do sbírky přidat otevřením na kartě " Collections "a kliknutím na tlačítko"Manage Environments". Tyto proměnné pak budete moci použít uvnitř dotazů zadáním jako>. To je užitečné například pro práci s různými prostředími (test, vývoj, produkce) nebo pro přenos dynamických hodnot v dotazech.

Registrace účtu

Pro vytvoření sbírky v Postman je nutné zaregistrovat účet. To vám umožní ukládat a synchronizovat vaše sbírky mezi zařízeními, sdílet je s ostatními uživateli a přistupovat k dalším možnostem.

  1. Přejděte na oficiální web Postman.
  2. Klikněte na tlačítko " Sign up "(registrovat se).
  3. Vyberte způsob registrace: prostřednictvím e-mailu nebo prostřednictvím účtů Google nebo GitHub.
  4. Vyplňte požadovaná pole formuláře: uživatelské jméno, e-mail a heslo.
  5. Zaškrtněte políčka souhlas s podmínkami použití a zásadami ochrany osobních údajů.
  6. Klikněte na tlačítko "Create Account" (vytvořit účet).
  7. Potvrďte svou registraci podle pokynů, které budou odeslány na Vámi uvedenou e-mailovou adresu.

Po dokončení registrace se budete moci přihlásit ke svému účtu a začít vytvářet své sbírky v Postman. Registrovaný účet umožňuje ukládat požadavky, proměnné prostředí a další nastavení, vytvářet požadavky na externí rozhraní API a provádět mnoho dalších užitečných činností.

Instalace Postman do počítače

Chcete-li nainstalovat Postman do počítače, postupujte podle následujících kroků:

  1. Přejděte na oficiální stránky Postman na https://www.postman.com/.
  2. Klikněte na tlačítko "stáhnout aplikaci" v horní části stránky.
  3. Vyberte verzi aplikace, která odpovídá vašemu operačnímu systému (Windows, macOS nebo Linux).
  4. Klikněte na tlačítko" Stáhnout " a počkejte na dokončení stahování.
  5. Spusťte instalační program Postman podle pokynů na obrazovce.

Po dokončení instalace bude Postman k dispozici na vašem počítači. Nyní jej můžete začít používat k vytváření a odesílání dotazů na rozhraní API, testování a ladění aplikací.

Důležitě: Kromě standardní instalace nabízí Postman také webovou verzi aplikace, kterou lze použít bez instalace do počítače. Přístup k webové verzi lze získat na oficiálních stránkách Postman po registraci účtu.

Vytvoření nové kolekce

Chcete-li vytvořit novou kolekci v Postman, postupujte podle následujících kroků:

  1. Otevřete v počítači aplikaci Postman.
  2. V levém podokně klikněte na tlačítko"sbírky".
  3. V nabídce, která se otevře, vyberte možnost "Vytvořit sbírku".
  4. V dialogovém okně, které se zobrazí, zadejte název pro vaši novou kolekci a klikněte na tlačítko Uložit.

Nyní máte novou prázdnou sbírku, do které můžete přidat požadavky a upravit jejich nastavení. Vytvořenou sbírku můžete použít k provádění testovacích dotazů, organizaci a strukturování projektu nebo ke spolupráci s ostatními členy týmu.

Přidání požadavků do sbírky

Po vytvoření kolekce v Postman, můžete do ní přidat různé požadavky pro další použití. Přidání požadavků do sbírky je velmi snadné a pohodlné.

Chcete-li přidat požadavek do sbírky, postupujte podle následujících kroků:

  1. Otevřete sbírku, do které chcete přidat dotaz.
  2. Klikněte na tlačítko" Přidat dotaz " v pravém horním rohu obrazovky.
  3. Zadejte název dotazu a vyberte jeho typ (GET, POST, PUT, DELETE atd.).
  4. Zadejte adresu URL dotazu a v případě potřeby přidejte možnosti.
  5. V případě potřeby můžete přidat nadpisy dotazu.
  6. Pokud je to nutné, přidejte tělo požadavku, jako je JSON nebo datový formulář.
  7. Klepnutím na tlačítko Uložit přidejte dotaz do sbírky.

Jakmile je požadavek přidán do sbírky, můžete jej kdykoli snadno zopakovat výběrem příslušné sbírky a dotazem v ní.

Také v Postman můžete k dotazu přidat automatické testy a funkční skripty a provádět je v různých prostředích a na různých zařízeních.

Nastavení parametrů požadavků

Postman vám umožňuje konfigurovat nastavení požadavků pro provádění různých akcí. K tomu je třeba použít kartu "Params" v okně pro úpravu dotazu.

Na této kartě můžete zadat různé možnosti dotazů, jako jsou možnosti query, možnosti záhlaví, možnosti těla dotazu a další.

Query-možnosti jsou možnosti, které se přidají na adresu URL dotazu po znaku otázky ("?"). Novou možnost Query můžete přidat zadáním jejího názvu a hodnoty do příslušných polí. Můžete také přidat několik možností query kliknutím na tlačítko "Add Query Parameter".

Možnosti záhlaví umožňují zadat názvy dotazů. Novou možnost záhlaví můžete přidat zadáním jejího názvu a hodnoty do příslušných polí. Můžete také přidat několik možností záhlaví kliknutím na tlačítko "Add Header".

Parametry těla požadavku umožňují zadat data, která budou odeslána spolu s dotazem. Můžete si vybrat různé datové formáty, jako je JSON, XML, formuláře a další. Chcete-li to provést, musíte vybrat požadovaný formát dat z rozbalovací nabídky Body a poté zadat příslušná data do vstupního pole.

Jakmile nastavíte všechny možnosti dotazu, můžete požadavek odeslat kliknutím na tlačítko "Send". Postman provede dotaz se zadanými možnostmi a zobrazí odpověď na kartě "Response".

Konfigurováním nastavení dotazů v Postman můžete přesněji spravovat provádění dotazů a kontrolovat jejich výsledky.

Kontrola dotazů

Když jste vytvořili sbírku v Postman a přidali požadované požadavky, je čas zkontrolovat jejich funkčnost.

Postman poskytuje výkonné nástroje pro kontrolu a ladění dotazů. Dotazy můžete odeslat a získat odpovědi ze serveru v reálném čase. To vám umožní rychle se ujistit, že váš kód funguje správně nebo rychle opravit chyby.

Kontrola dotazů v Postmanu se provádí následovně:

  1. Otevřete sbírku v Postman.
  2. Ze seznamu požadavků ve sbírce vyberte dotaz, který chcete zkontrolovat.
  3. Klikněte na tlačítko "Send" (odeslat) vedle zvoleného požadavku.
  4. Postman odešle požadavek na server a obdrží odpověď. Odpověď můžete vidět v části "Response" (odpověď) ve spodní části obrazovky Postman.
  5. Analyzujte přijatou odpověď, abyste se ujistili, že požadavek byl úspěšně splněn a vrátil očekávaný výsledek.

Pokud je požadavek úspěšný, zobrazí se stavový kód 200 a získaná data v tabulkovém formuláři nebo ve formátu JSON v části "Response". Pokud dotaz nebyl úspěšně proveden, zobrazí se příslušný stavový kód (například 404 pro stránku nenalezeno) a zpráva s popisem chyby.

Pokud jste našli chyby v dotazu nebo jste neobdrželi očekávaný výsledek, můžete změnit nastavení dotazu, přidat záhlaví, upravit autorizaci atd. pro zlepšení požadavku a jeho opakování.

Postman také poskytuje vynikající nástroje pro ladění požadavků. Režim "Debug" (ladění) můžete použít k procházení dotazu krok za krokem a jeho kontrole během provádění. V případě potřeby můžete přidat body zastavení a zobrazit proměnné a hodnoty.

Kontrola dotazů je důležitou součástí vývoje a testování API. S Postmanem můžete rychle a snadno zkontrolovat své požadavky a ujistit se, že fungují správně.

Vytváření proměnných prostředí

Proměnné prostředí v Postman vám umožňují ukládat a používat hodnoty, které se mohou měnit v závislosti na prostředí, ve kterém je váš požadavek proveden. Jsou užitečné pro správu různých konfigurací a ukládání citlivých dat, jako jsou tokeny a hesla.

Chcete-li v Postman vytvořit proměnné prostředí, postupujte podle těchto kroků:

  1. Otevřete Postman a v horní části okna vyberte kartu "manage Environments".
  2. Kliknutím na tlačítko" Add " vytvoříte nové prostředí.
  3. Do pole "Name"zadejte název svého okolí. Například "Development " nebo"Production".
  4. Kliknutím na tlačítko "Add" přidáte proměnné do svého okolí.
  5. Zadejte název proměnné do pole " Key "a hodnotu proměnné do pole"initial Value".
  6. Kliknutím na tlačítko "Uložit" uložíte proměnnou.

Nyní můžete tyto proměnné použít v dotazech tím, že je označíte jako >. Postman při provádění dotazu automaticky nastrčí příslušnou hodnotu.

Chcete-li změnit hodnotu proměnné prostředí, jednoduše otevřete kartu "manage Environments", vyberte požadované prostředí a změňte hodnotu proměnné.

Vytváření proměnných prostředí vám pomůže zjednodušit a urychlit proces testování v Postmanu, což vám umožní efektivněji pracovat na vašem projektu.

Instalace autorizace

Autorizace vám umožňuje odeslat požadavky s autentizačními údaji, jako jsou přístupové tokeny nebo klíče API. Postman poskytuje několik možností autorizace, včetně základního ověřování, OAuth 2.0 a tokenů Bearer.

1. Chcete-li nastavit autorizaci, musíte otevřít kartu Authorization v okně pro úpravu dotazu.

2. V poli Type vyberte metodu ověřování, která odpovídá vašemu případu. Pokud například používáte přístupový token, vyberte Bearer Token.

3. Vyplňte požadovaná pole podle zvolené metody. Pokud jste například vybrali OAuth 2.0, budete muset zadat Token Name a Access Token.

4. Pokud je to nutné, můžete do požadavku přidat možnosti autorizace pomocí karty Headers nebo Params.

5. Po nastavení autorizace můžete odeslat požadavek a ujistit se, že je úspěšný s přenesenými autorizačními daty.

Instalace autorizace do Postman vám umožňuje přistupovat k zabezpečeným API a komunikovat s nimi pomocí autentizačních údajů, které potřebujete.

Export a import sbírek

Postman poskytuje možnost exportovat a importovat sbírky pro sdílení dat nebo zálohování. Je to užitečná funkce, která vám umožní udržet si práci a snadno ji sdílet s ostatními.

Chcete-li sbírku exportovat, postupujte podle následujících kroků:

  1. Do vyhledávacího pole zadejte název sbírky nebo jej vyberte ze seznamu sbírek.
  2. Klikněte pravým tlačítkem myši na sbírky a vyberte Exportovat.
  3. Vyberte formát exportu (například JSON nebo CSV) a zadejte cestu pro uložení souboru.
  4. Kliknutím na "Exportovat" vytvoříte soubor exportu.

Chcete-li importovat sbírku, postupujte podle následujících kroků:

  1. Klikněte na tlačítko Importovat v horní navigační liště.
  2. Vyberte soubor se sbírkou, kterou chcete importovat.
  3. Vyberte cílovou kolekci nebo vytvořte novou kolekci pro import.
  4. Kliknutím na" Importovat " nahrajete soubor importu a přidáte jej do své sbírky.

Při exportu a importu kolekcí ukládá Postman všechny požadavky, proměnné, ověřování a další nastavení, která jste ve sbírce identifikovali.

Použijte funkci exportu a importu do Postman pro efektivnější spolupráci s ostatními vývojáři a správu vašich sbírek.