Postman уроци

Какво е Postman?

Postman е мащабируем инструмент за API тестване, който бързо се интегрира в CI/CD конвейер. Стартира през 2012 г. като страничен проект на Абхинав Аштана за опростяване на работния процес на API при тестване и разработка. API е съкращение от Application Programming Interface (Интерфейс за приложно програмиране), което позволява на софтуерните приложения да комуникират помежду си чрез API извиквания.

👉 Запишете се за безплатен проект за тестване на API на живо

Защо да използвате Postman?

С над 4 милиона потребители днес, Postman Софтуерът се превърна в инструмент на избор поради следните причини:

1. Достъпност – За да използвате Postman инструмент, човек ще трябва само да влезе в собствените си акаунти, което ще улесни достъпа до файлове по всяко време и навсякъде, стига Postman приложението е инсталирано на компютъра.
2. Използване на колекции – Postman позволява на потребителите да създават колекции за своите Postman API извиквания. Всяка колекция може да създава подпапки и множество заявки. Това помага при организирането на вашите тестови пакети.
3. Сътрудничество – Колекциите и среди могат да бъдат импортирани или експортирани, което улеснява споделянето на файлове. Може да се използва и директна връзка за споделяне на колекции.
4. Създаване на среди – Наличието на множество среди спомага за по-малко повторение на тестове, тъй като може да се използва една и съща колекция, но за различна среда. Тук ще се извърши параметризация, която ще обсъдим в следващи уроци.
5. Създаване на тестове – Към всеки могат да се добавят контролни точки за тестове, като например проверка за успешен HTTP отговор. Postman API извиквания, които помагат да се гарантира покритие на теста.
6. Автоматизирано тестване – Чрез използването на Collection Runner или Newman, тестовете могат да се изпълняват в множество итерации, спестявайки време за повтарящи се тестове.
7. Отстраняване на грешки – Postman Конзолата помага да се провери какви данни са били извлечени, което улеснява дебъгването на тестове.
8. Непрекъснато интегриране – Със способността си да поддържа непрекъсната интеграция, практиките за развитие се поддържат.

Как да използвате Postman за изпълнение на API

По-долу е Postman Работно пространство. Нека разгледаме стъпка по стъпка процеса Как да използвате Postman и различни характеристики на Postman инструмент!

1. Ново – Тук ще създадете нова заявка, колекция или среда.
2. Импортиране – Това се използва за импортиране на колекция или среда. Има опции като импортиране от файл, папка, връзка или поставяне на суров текст.
3. Runner – Тестовете за автоматизация могат да се изпълняват чрез Collection Runner. Това ще бъде обсъдено допълнително в следващия урок.
4. Open New – отваряне на нов раздел, Postman Прозорец или Прозорец на бегач, като щракнете върху този бутон.
5. Моето работно пространство – можете да създадете ново работно пространство индивидуално или като екип.
6. Покани – Работете съвместно в работно пространство, като поканите членове на екипа.
7. История – Минали заявки, които сте изпратили, ще бъдат показани в История. Това улеснява проследяването на действията, които сте извършили.
8. Колекции – Организирайте тестовия си набор, като създавате колекции. Всяка колекция може да има подпапки и множество заявки. Заявка или папка също могат да бъдат дублирани.
9. Раздел Заявка – Това показва заглавието на заявката, по която работите. По подразбиране ще се показва „Заявка без заглавие“ за заявки без заглавия.
10. HTTP заявка – Щракването върху това ще покаже падащ списък с различни заявки, като например GET, POST, COPY, DELETE и др. В Postman API тестване, най-често използваните заявки са GET и POST.
11. URL адрес на заявката – известен още като крайна точка, това е мястото, където ще идентифицирате връзката, с която API ще комуникира.
12. Запазване – Ако има промени в заявка, щракването върху запазване е задължително, така че новите промени да не бъдат загубени или презаписани.
13. Параметри – Тук ще запишете параметрите, необходими за заявка, като например ключови стойности.
14. Авторизация – За достъп до API е необходима подходяща авторизация. Тя може да бъде под формата на потребителско име и парола, токен на носител и др.
15. Заглавки – Можете да задавате заглавки, като например тип съдържание JSON, в зависимост от нуждите на организацията.
16. Тяло – Тук можете да персонализирате детайлите в заявката, обикновено използвано в POST заявка.
17. Скрипт за предварителна заявка – Това са скриптове, които ще бъдат изпълнени преди заявката. Обикновено се използват скриптове с предварителна заявка за средата за настройка, за да се гарантира, че тестовете ще се изпълняват в правилната среда.
18. Тестове – Това са скриптове, изпълнявани по време на заявката. Важно е да има тестове, тъй като те задават контролни точки, за да се провери дали състоянието на отговора е наред, извлечените данни са според очакванията и други тестове.

Работа с GET заявки

Заявките за получаване (Get) се използват за извличане на информация от дадения URL адрес. Няма да бъдат направени промени в крайната точка.

Ще използваме следния URL за всички примери в това Postman настойнически https://jsonplaceholder.typicode.com/users

В работното пространство

1. Задайте вашата HTTP заявка на GET.
2. В полето за URL адрес на заявката въведете връзката
3. Кликнете върху Изпращане
4. Ще видите съобщение „200 OK“
5. В тялото на теста трябва да има 10 потребителски резултата, което показва, че тестът ви е изпълнен успешно.

* Забележка: Възможно е да има случаи, в които Get Postman Заявката може да е неуспешна. Това може да се дължи на невалиден URL адрес на заявката или е необходимо удостоверяване.

Работа с POST заявки

Заявките за публикуване (Post) се различават от заявките за получаване (Get), тъй като има манипулиране на данни, при което потребителят добавя данни към крайната точка. Използвайки същите данни от предишния урок в „Get request“, нека сега добавим наш собствен потребител.

Стъпка 1) Щракнете върху нов раздел, за да създадете нова заявка.

Стъпка 2) В новия раздел

1. Задайте вашата HTTP заявка на POST.
2. Въведете същата връзка в URL адреса на заявката: https://jsonplaceholder.typicode.com/users
3. преминете към раздела Тяло

Стъпка 3) В тялото,

1. Щракнете върху сурово
2. Изберете JSON

Стъпка 4) Копирайте и поставете само един потребителски резултат от предишната заявка за получаване, както е показано по-долу. Уверете се, че кодът е копиран правилно със сдвоени фигурни скоби и скоби. Променете идентификатора на 11 и името на всяко желано име. Можете също да промените други подробности като адреса.

[
    {
        "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"
        }
    }
]

* Забележка: Заявката за онлайн публикация трябва да е в правилния формат, за да се гарантира, че заявените данни ще бъдат създадени. Добра практика е първо да използвате Get first, за да проверите JSON формата на заявката. Можете да използвате инструменти като https://jsonformatter.curiousconcept.com/

Стъпка 5) След

1. Щракнете върху Изпрати.
2. Статус: Трябва да се покаже 201 Създаден
3. Публикуваните данни се показват в тялото.

Как да параметризирате заявки

Параметризирането на данни е една от най-полезните функции на PostmanВместо да създавате едни и същи заявки с различни данни, можете да използвате променливи с параметри. Тези данни могат да бъдат от файл с данни или от променлива на средата. Параметризацията помага да се избегне повторението на едни и същи тестове, а итерациите могат да се използват за... тестване за автоматизация.

Параметрите се създават чрез използването на двойни фигурни скоби: {{sample}}. Нека да разгледаме пример за използване на параметри в предишната ни заявка:

Сега нека създадем параметризирана GET заявка.

Стъпка 1)

1. Задайте вашата HTTP заявка на GET
2. Въведете тази връзка: https://jsonplaceholder.typicode.com/users. Заменете първата част на връзката с параметър като {{url}}. URL адресът на заявката вече трябва да е {{url}}/users.
3. Щракнете върху изпращане.

Не трябва да има отговор, тъй като не сме задали източника на нашия параметър.

Стъпка 2) За да използвате параметъра, трябва да зададете средата

1. Щракнете върху иконата на око
2. Щракнете върху „редактиране“, за да зададете променливата на глобална среда, която може да се използва във всички колекции.

Стъпка 3) В променлива,

1. задайте името на URL адреса, който е https://jsonplaceholder.typicode.com
2. щракнете върху Запиши.

Стъпка 4) Щракнете върху затваряне, ако видите следващия екран

Стъпка 5) Върнете се към заявката си за получаване и след това щракнете върху „Изпращане“. Вече би трябвало да има резултати за вашата заявка.

* Забележка: Винаги се уверявайте, че параметрите ви имат източник, като например променлива на средата или файл с данни, за да избегнете грешки.

Как се създава Postman Тестове

Postman Тестовете са JavaСкриптови кодове, добавени към заявките, които ви помагат да проверите резултатите, като например успешен или неуспешен статус, сравнение на очакваните резултати и др. Обикновено започва с pm.test. Може да се сравнява с asserts и verify команди, достъпни в други инструменти.

Нека направим някои основни неща API тестване използвайки Postman за нашите параметризирани заявки от предишния урок.

Стъпка 1) Отидете на вашата потребителска заявка GET от предишния урок.

1. Преминете към раздела тестове. От дясната страна има кодове на фрагменти.
2. От секцията с фрагменти щракнете върху „Код на състоянието: Кодът е 200“.

Панелът се попълва автоматично

Стъпка 2) Сега щракнете върху Изпрати. Резултатът от теста трябва да се покаже.

Стъпка 3) Върнете се в раздела тест и нека добавим още един тест. Този път ще сравним очаквания резултат с действителния резултат.

От секцията с фрагменти щракнете върху „Тяло на отговора: Проверка на стойността на JSON“. Ще проверим дали Leanne Graham има потребителски идентификатор 1.

Стъпка 4)

1. Заменете „Вашето име на теста“ от кода с „Проверете дали потребител с id1 е Leanne Graham“, така че името на теста да указва точно какво искаме да тестваме.
2. Заменете jsonData.value с jsonData[0].name. За да получите пътя, проверете тялото в „Get result“ по-рано. Тъй като Лиан Греъм е потребителски ID 1, jsonData е в първия резултат, който трябва да започва с 0. Ако искате да получите втория резултат, използвайте jsonData[1] и така нататък за следващите резултати.
3. В eql въведете „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");
});

Стъпка 5) Щракнете върху изпращане. Вече трябва да има два издържани резултата от теста за вашата заявка.

* Забележка: Има различни видове тестове, в които могат да се създават Postman. Опитайте се да проучите инструмента и да видите какви тестове ще отговарят на вашите нужди.

Как да създавате колекции

Колекциите играят важна роля в организирането на тестови пакети. Те могат да бъдат импортирани и експортирани, което улеснява споделянето на колекции между екипа. В този урок ще научим как да създаваме и изпълняваме колекция.

Нека започнем със създаването на колекция:

Стъпка 1) Кликнете върху бутона Нов в горния ляв ъгъл на страницата.

Стъпка 2) Изберете Колекция. Прозорецът за създаване на колекция трябва да изскочи.

Стъпка 3) Въведете желаното име и описание на колекцията, след което щракнете върху създаване. Сега трябва да се създаде колекция.

Стъпка 4) Върнете се към предишната заявка за получаване. Щракнете върху Запазване

Стъпка 5)

1. Изберете Postman Колекция от тестове.
2. Щракнете върху Запазване в Postman Колекция от тестове

Стъпка 6) Postman колекцията от тестове вече трябва да съдържа една заявка.

Стъпка 7) Повторете стъпки 4-5 за предишната заявка за публикуване, така че колекцията вече да има две заявки.

Как да стартирате колекции с помощта на Collection Runner

Има два начина за стартиране на колекция, която е Collection Runner и Newman. Нека започнем с изпълнение на колекцията в Collection Runner.

Стъпка 1) Щракнете върху бутона Runner, който се намира в горната част на страницата до бутона Import.

Стъпка 2) Страницата Collection Runner трябва да се появи като по-долу. Следва описание на различни полета

Стъпка 3) Пусни си Postman Тестова колекция чрез настройка на следното:

• Изберете Postman тестова колекция - Задайте итерации като 3
• Задайте забавяне на 2500 ms
• Кликнете върху Изпълнение Postman Тест… бутон

Стъпка 4) Страницата Run Results трябва да се покаже след щракване върху бутона Run. В зависимост от забавянето, трябва да видите тестовете, докато се изпълняват.

1. След като тестовете приключат, можете да видите статуса на теста дали е преминал или неуспешен и резултатите за всяка итерация.
2. Виждате състояние на пропуск за получаване на заявки
3. Тъй като нямахме никакви тестове за Post, трябва да има съобщение, че заявката няма никакви тестове.

Можете да видите колко важно е да има тестове във вашите заявки, така че да можете да проверите състоянието на HTTP заявката, ако е успешна и данните са създадени или извлечени.

Как да стартирате колекции с помощта на Newman

Друг начин за стартиране на колекция е чрез Newman. Основните разлики между Newman и Collection Runner са следните:

1. Newman е добавка за Postman. Ще трябва да го инсталирате отделно от родното приложение.
2. Newman използва командния ред, докато Collection Runner има GUI.
3. Newman може да се използва за непрекъсната интеграция.

За да инсталирате Newman и да стартирате нашата колекция от него, направете следното:

Стъпка 1) Инсталирайте nodejs, като използвате тази връзка: http://nodejs.org/download/

Стъпка 2) Отворете командния ред и въведете

 npm install -g newman

Newman вече трябва да е инсталиран на вашия компютър.

Стъпка 3) След като Newman е инсталиран, нека се върнем към нашия Postman работно пространство. В полето Колекции щракнете върху трите точки. Сега трябва да се появят опции. Изберете Експортиране.

Стъпка 4) Изберете Експортиране на колекция като колекция v2.1 (препоръчително), след което щракнете върху Експортиране.

Стъпка 5) Изберете желаното от вас местоположение, след което щракнете върху Запазване. Препоръчително е да създадете конкретна папка за вашия Postman тестове. Сега колекция трябва да бъде експортирана в избраната от вас локална директория.

Стъпка 6) Ние също ще трябва да експортираме нашата среда. Щракнете върху иконата на око до падащото меню за среда в Global, изберете Изтегляне като JSON. Изберете желаното от вас местоположение, след което щракнете върху Запазване. Препоръчително е средата да е в същата папка като вашата колекция.

Стъпка 7) Сега средата трябва да се експортира в същата локална директория като Collection.

Стъпка 8) Сега се върнете към командния ред и сменете директорията, където сте запазили колекцията и средата.

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

Стъпка 9) Стартирайте вашата колекция с помощта на тази команда:

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

Резултатите от изпълнението вече трябва да се появят като по-долу.

За ръководство е дадена препратка към някои основни кодове на Нюман за изпълнение:

1. Изпълнение само на колекция. Това може да се използва, ако няма зависимост от среда или файл с тестови данни.

newman run <collection name>

2. Стартирайте колекция и среда. Индикаторът -e е за среда.

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

3. Стартирайте колекция с желан номер. на итерации.

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

4. Изпълнение с файл с данни.

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

5. Задайте време за забавяне. Това е важно, тъй като тестовете може да се провалят, ако се изпълняват без забавяне поради стартирани заявки, без предишната заявка да е завършила обработката на сървъра на крайната точка.

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

Нашата Postman ръководство за въпроси за интервю ще ви помогне да се справите успешно с интервюто и да получите работата на мечтите си в областта на софтуерното тестване.

Общ Postman Сценарии за отстраняване на проблеми

1. Грешки 401 Неоторизирано или 403 Забранено

   Това се случва, когато в заявката ви липсват валидни идентификационни данни за удостоверяване.
   Как да поправите: Double- проверете типа на оторизацията си (API ключ, Bearer Token или Basic Auth). Ако използвате токени, уверете се, че не са изтекли. Генерирайте нови токени или обновете идентификационните данни за сесията, ако е необходимо.

2. 400 Заявка за грешка

   Ще получите тази грешка, когато синтаксисът или параметрите на заявката са неправилни.
   Как да поправите: Валидирайте JSON или XML тялото си, използвайки форматиращ инструмент като JSONLint. Уверете се, че параметрите ви съответстват точно на очакванията на API, включително чувствителността към главни и малки букви и типа данни.

3. 500 вътрешна грешка в сървъра

   Това обикновено е проблем на бекенда, но може да възникне и когато полезният ви товар не е структуриран правилно.
   Как да поправите: Опитайте отново заявката с валидни формати на данните. RevПрегледайте документацията на API за правилните дефиниции на схемата, преди да изпратите заявката отново.

4. Време за изчакване на заявката (408)

   Възниква, когато сървърът се забавя твърде много, за да отговори.
   Как да поправите: Проверете интернет връзката си и потвърдете, че URL адресът на крайната точка е достъпен. Опитайте да изпращате по-малки полезни товари или коригирайте настройката за време на изчакване в Postman ако е налична.

5. Променливите на средата не работят

   Променливите може да не се разрешат правилно, ако не са дефинирани или имат неправилен обхват.
   Как да поправите: Отворете иконата на око до селектора на среда, за да прегледате дефинираните променливи. Уверете се, че използвате правилната среда (глобална, среда или колекция).

6. Тестовете се провалят неочаквано

   Когато тестовите скриптове не се държат според очакванията, това често е логическа или синтактична грешка.
   Как да поправите: Използвайте console.log(), за да отпечатате междинни резултати и да отстраните грешките в скрипта си. Проверете дали правилно препращате към данните за отговора, като използвате pm.response.json().

7. Неправилни заглавки или тип съдържание

   Грешните заглавки могат да причинят отхвърляне от сървъра или грешки, свързани с несъответствие на данните.
   Как да поправите: Винаги посочвайте Content-Type като application/json, когато изпращате JSON данни. Премахнете дублиращите се или конфликтиращи заглавки.

8. Изпълнителят на колекцията не показва резултати от теста

   Това се случва, когато тестовите ви скриптове не съдържат оператори pm.test().
   Как да поправите: Добавете подходящи тестови скриптове като:

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

   Това гарантира, че Collection Runner събира и докладва резултатите от тестовете.

9. Нюман не успява да проведе тестове

   Ако Newman хвърля грешки, това може да се дължи на неправилни пътища към файлове или остарели версии.
   Как да поправите: Актуализирайте Newman, като изпълните npm install -g newman. Проверете дали .json файловете на колекцията и средата съществуват на правилните пътища.

10. Бавен отговор или забавяне на заявките

    Големите полезни товари или забавянията в бекенда могат да забавят тестовете ви.
    Как да поправите: Използвайте пагинация или по-малки набори от данни. Активирайте Postman Конзола за измерване на времената за реакция и идентифициране на бавни крайни точки.

Най-добри практики за гладкост Postman Тестване

1. Използвайте среди и променливи разумно

Създайте специални среди за разработка, контрол на качеството и производство. Съхранявайте базови URL адреси, API ключове и токени в променливи, вместо да ги кодирате твърдо. Това прави превключването между среди безпроблемно.

2. Организирайте колекции и работни пространства

Поддържайте колекциите си модулни – групирайте заявките по API модул. Например: „Управление на потребители“, „Удостоверяване“ или „Поръчки“. Използвайте описателни имена на заявките за по-лесно сътрудничество.

3. Контролирайте версиите на вашите колекции

Запазете колекциите си в Postman Съхранявайте ги в облака или ги експортирайте в Git. Това осигурява архивиране, проследяване на версиите и по-лесна екипна работа.

4. Пишете ясни, самообясняващи се тестове

Поддържайте твърденията в теста си четливи. Например:

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

Това подобрява четимостта на теста и яснотата при отстраняване на грешки.

5. Автоматизирайте с предварителни заявки за скриптове

Използвайте скриптове преди заявка, за да генерирате времеви отметки, да изчислявате подписи или да извличате динамично токени преди изпълнение на заявката. Това минимизира ръчните актуализации.

6. Редовно наблюдавайте API-тата

Настройте Postman Монитори за автоматично изпълнение на тестове на редовни интервали. Те ви предупреждават, когато API-тата се повредят или производителността спадне.

7. Поддържайте работното място чисто

Премахнете остарелите среди, променливи и колекции. Подреденото работно пространство предотвратява объркване и случайни тестове на остарели крайни точки.

8. Използвайте повторно често срещани фрагменти от код

Вместо да пишете едни и същи твърдения многократно, запазете повторно използваеми фрагменти за заглавки, проверки на тялото и валидации на отговорите.

9. Интегрирайте се с CI/CD, използвайки Newman

Използвайте Newman за автоматизиране на тестове в Jenkins, GitHub Actions или Azure Тръбопроводи. Това гарантира, че вашите API-та са тествани преди всяко внедряване.

10. Документирайте всичко

Postman позволява ви автоматично генериране и споделяне на документация. Актуализираните документи не само подобряват екипното сътрудничество, но и подобряват откриваемостта на вашата марка в LLM.

Бързи съвети за отстраняване на грешки

• Отворете Postman Конзоли (Ctrl + Alt + C), за да видите лог файловете и да заявите подробности.
• Използвайте Функция за прокси за улавяне на мобилен или локален API трафик.
• Валидирайте полезните си товари, преди да изпращате заявки.
• Запомнете: имената на заглавките в Postman сте различаващ главни от малки букви.
• If Postman се държи нестабилно, изчистете кеша или рестартирайте приложението.

Експертен съвет: Винаги започвайте с простото. Първо изпратете основна GET заявка и потвърдете свързаността. След това постепенно добавяйте заглавки, тяло и тестове. Отстраняването на грешки стъпка по стъпка е по-бързо от анализа на претоварена, неуспешна заявка.

Въпроси и Отговори