Урок за POSTMAN: Тестване на API с помощта на POSTMAN

postman tutorial api testing using postman

Този урок стъпка по стъпка обяснява API тестване с помощта на POSTMAN Включва основите на POSTMAN, неговите компоненти и примерна заявка и отговор:

Разгледахме най-често задаваните въпроси Въпроси за интервю за ASP.Net и Web API в предишния ни урок. Преглеждайки този урок, ще научите как подхождаме към API Тестване чрез POSTMAN за всеки даден URL адрес.

Postman е много прост и интуитивен инструмент или приложение за тестване на API. Всеки компонент в POSTMAN е много важен, тъй като има собствено значение.

=> Прочетете пълната серия за тестване на API тук .

най-добре конвертирате YouTube видео в mp3

Списък на всички уроци за пощальони в тази поредица

Урок # 1: Въведение на пощальона (този урок)
Урок # 2: Как да използвам пощальон за тестване на Diff API формати
Урок № 3: Пощальон: Променлив обхват и файлове от околната среда
Урок № 4: Колекции на пощальони: Импортиране, експортиране и генериране на проби от кодове
Урок № 5: Автоматизиране на валидирането на отговорите с твърдения
Урок # 6: Пощальон: Предварително запитване и скриптове за публикуване на заявки
Урок № 7: Пощальон Разширени скриптове
Урок № 8: Пощальон - Интеграция с команден ред с Newman
Урок № 9: Пощальон - Шаблони за отчитане с Newman
Урок № 10: Пощальон - Създаване на API документация
Урок # 11: Въпроси за интервю за пощальон

Общ преглед на уроци в пощенски поредици

Какво ще научите:

• ПОЩМАН Въведение
• Инсталиране на POSTMAN
  • Postman Native App
  • Алтернативно ръководство за бързо инсталиране на пощальон
  • Изграждащи блокове на ПОСТМАН
    • # 1) Заявка
    • # 2) Колекция
    • # 3) Околна среда
  • Запазване на заявка в колекция
• Примерно искане и отговор
• Актуализация: Допълнителна информация
  • Какво е API?
  • Пощенски клиент
    • Как да изтеглите клиента на POSTMAN?
  • Обадете се на REST API с помощта на POSTMAN Client
    • # 1) ПОЛУЧЕТЕ обаждане
    • # 2) POST повикване
    • # 3) PUT Call
    • # 4) Изтриване на повикване
  • Предизвикателства при API тестване
• Заключение
  • Препоръчително четене

ПОЩМАН Въведение

POSTMAN е API клиент, използван за разработване, тестване, споделяне и документиране на API. Той се използва за бекенд тестване, където въвеждаме URL на крайната точка, той изпраща заявката до сървъра и получава отговора обратно от сървъра. Същото може да се постигне и чрез API шаблони като Swagger. И в Swagger, и в POSTMAN не е необходимо да изграждаме рамка (за разлика от Parasoft), за да извлечем отговора от услугата.

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

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

Ето видео урок:

Пощальонът предлага много разширени функции като:

• Разработка на API.
• Настройване на Mock крайни точки за API, които все още са в процес на разработка.
• API документация.
• Твърдения за отговорите, получени от изпълнението на крайната точка на API.
• Интеграция с инструменти за CI-CD като Jenkins, TeamCity и др.
• Автоматизиране на изпълнението на API тестове и др.

Сега преминахме през официалното въвеждане на инструмента, нека да преминем към инсталационната част.

Инсталиране на POSTMAN

Пощальонът се предлага в 2 опции.

1. Като приложение за Chrome (това вече е оттеглено и няма поддръжка от разработчиците на Postman)
2. Родно приложение за различни платформи като Windows, Mac OS, Linux и др.

Тъй като приложенията на Chrome са оттеглени и имат тясна връзка с браузъра Chrome (в няколко случая действителната версия на браузъра), ще се съсредоточим най-вече върху приложението Native, което ни дава повече контрол и има по-малки външни зависимости.

Postman Native App

Приложението Postman Native е самостоятелно приложение, което е достъпно за Изтегли в различни платформи на ОС като Windows, Mac OS, Linux и др. Това може да бъде изтеглено, както всяко друго приложение, в зависимост от платформата на потребителя.

Процесът на инсталиране също е доста ясен. Просто трябва да щракнете двукратно върху изтегления инсталатор (за Windows и Mac) и да следвате инструкциите.

След като инсталацията е успешна, просто отворете приложението Postman, за да започнете.

Ще видим как да създадем проста заявка за всеки наличен API с отворен код и ще видим различните компоненти на заявката и отговора, получени, когато заявката се изпълнява с помощта на приложението Postman.

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

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

Ще илюстрираме примерна GET заявка към това URL което ще върне 100 публикации в отговор като JSON полезен товар.

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

# 1) Отворете приложението за пощальон (Ако все още не сте влезли със съществуващия или новия акаунт, първо влезте със съответните идентификационни данни).

По-долу е изображението на началния екран на потребителския интерфейс на Postman:

# две) Създайте нова заявка и попълнете подробностите според крайната точка, която ще използваме за нашия тест или илюстрация. Нека тестваме заявка за получаване на крайна точка на REST API http://dummy.restapiexample.com/api/v1/employees

# 3) След като свойствата на заявката бъдат попълнени, натиснете SEND, за да изпълните заявката към сървъра, хостващ крайната точка.

# 4) След като сървърът отговори, можем да проверим различните данни около отговора.

Нека да видим всеки от тях в детайли.

По подразбиране, след като отговорът завърши, се избира и показва раздела тяло на отговора. Други параметри за отговор, като код на състоянието на отговора, времето, необходимо на попълването на заявката, размерът на полезния товар са показани точно под заглавията на заявката (както е показано на фигурата по-долу).

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

Например, за Време за заявка - ще го раздели допълнително на отделни компоненти като Време за свързване, Време за сокет, DNS търсене, Ръкостискане и др.

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

Сега нека разгледаме другите раздели за отговор, т.е. „бисквитки“ и заглавки. В уеб света бисквитките имат голямо значение по отношение на стимулирането на преживявания от страна на клиента и много информация, свързана със сесията, за да получат цялата информация за бисквитките, върнати от сървъра. Можете да превключите към раздела „бисквитки“ и да видите това.

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

Тук е важно да се отбележи, че всички заявки, които отправяте към сървъра, се съхраняват в историята на Postman за бъдещи справки (раздел „История“ е наличен в левия страничен панел на приложението).

Това помага за предотвратяване на създаването на заявки всеки път, когато трябва да получите отговор за една и съща заявка, а също така помага за избягване на обикновени задачи. Ако е необходимо, можете да се обърнете към миналите заявки (и отговорите също) в бъдещ момент.

Забележка: За да илюстрираме примерни заявки и отговори, ще използваме публично достъпни фалшиви API сървъри, които ще позволят да се правят всички видове HTTP заявки и които връщат валиден HTTP отговор.

За да назовем само няколко, ще използваме по-долу фалшивите сайтове за крайна точка на API като референция:

1. Пример за API за почивка
2. JSON Placeholder Typicode

Алтернативно ръководство за бързо инсталиране на пощальон

POSTMAN е отворен инструмент и е достъпен за всеки, който сърфира в интернет. Можете да следвате стъпките по-долу и да получите инструмента POSTMAN, инсталиран на вашата локална машина.

Етап 1: Отворете Google и потърсете инструмента POSTMAN. Ще получите резултата от търсенето по-долу. След това можете да кликнете върху Изтегляне на приложението Postman и ще бъдете пренасочени към уебсайта на getpostman.

В противен случай можете директно да отидете до това URL за да получите инструмента POSTMAN.

Стъпка 2: Изберете версията на POSTMAN въз основа на вашата операционна система. В нашия случай ще използваме POSTMAN за Windows OS. Освен това използваме Window-64 bit, така че ще изтеглим и инсталираме POSTMAN за 64 bit.

Стъпка 3: След като щракнете върху бутона Изтегляне, файл postman.exe ще бъде изтеглен във вашия локален. Кликнете върху този файл. Това е инсталация с едно кликване, точно както всяко друго приложение, което ще ви позволи да инсталирате добавката POSTMAN за вашия браузър.

Стъпка 4: След като инсталирате приложението, щракнете върху приложението (което трябва да бъде поставено на вашия работен плот). Както можете да видите на изображението по-долу, имаме шест различни обекта, за които основно ще ви трябват три строителни блока, т.е. Заявка, Събиране и Околна среда, които ще бъдат обсъдени в следващия раздел.

Това е!! Успешно инсталирахме и стартирахме приложението POSTMAN.

Изграждащи блокове на ПОСТМАН

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

Тези три основни градивни елемента са:

# 1) Заявка

Заявката не е нищо друго освен комбинация от пълния URL адрес (който включва всички параметри или ключове), HTTP заглавия, тяло или полезен товар. Тези атрибути изцяло формират заявка. POSTMAN ви позволява да запазите заявката си и това е добра характеристика на приложението, която ни позволява да използваме една и съща заявка толкова пъти, колкото искаме.

Кликнете върху Ново -> Заявка

# 2) Колекция

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

Кликнете върху Ново -> Колекция.

# 3) Околна среда

Околната среда е регион, в който ще се извършват всички ваши операции с API. Може да е TUP, QA, Dev, UAT или PROD. Всеки проект вече ще има конфигурирани региони и просто трябва да декларирате своите глобални променливи като URL, идентификатор и парола на маркера, контекстни ключове, API ключове, ключове на документи и така нататък в него.

Кликнете върху Ново -> Околна среда.

Запазване на заявка в колекция

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

Етап 1: В горния десен ъгъл ще видите бутона „+ Нов“. Щракнете върху този бутон и ще получите списъка със строителните блокове, които са показани, когато стартирате приложението за първи път.

Стъпка 2: Щракнете върху Заявка.

Стъпка 3: Посочете името на заявката, което е задължително поле. След това кликнете върху „+ Създаване на колекция“.

Стъпка 4: След като кликнете върху „+ Създаване на колекция“, той ще поиска име (да речем Примерна колекция). Въведете името на колекцията и натиснете Enter.

Стъпка 5: Щракнете върху „Запазване в колекция от проби“ бутон.

Примерно искане и отговор

Този конкретен раздел ще ви даде задълбочена представа за това как да тествате API в POSTMAN.

Както можете да видите на изображението по-долу, имаме нашата заявка, която вече сме създали (Тест за SoftwareTestingHelp). Освен това можете да видите падащо меню (точно до URL адреса), което съдържа глаголите или методите, които се поддържат от POSTMAN.

Те се наричат ​​HTTP глаголи. Ще се опитаме да актуализираме нещо с помощта на метода PUT и след това ще извлечем същото, използвайки метода GET. Предполагам, че читателите са наясно с функционалността на тези HTTP глаголи, които се използват при API тестване.

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

Ще декларираме нашите HTTP заглавки, т.е. Content-Type и Accept. Приемането не винаги е задължително, тъй като решава формата, в който ще извлечем отговора си. По подразбиране отговорът винаги е JSON.

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

След това ще преминем към следващия задължителен раздел, който е Body. Тук ще предоставим полезния товар под формата на JSON. Ние сме наясно как да напишем свой собствен JSON, затова ще се опитаме да създадем наш собствен JSON.

Искане за проба

URL: http://www.mocky.io/v2/5cd6c3f23000004b006061c5

Хедъри

Тип съдържание: application / JSON
Приемам = application / JSON

Тяло

Сега удари

След като получите пълна заявка, щракнете върху бутона „Изпрати“ и вижте кода за отговор. Кодът 200 OK означава успешна работа. На изображението по-долу можете да видите, че успешно сме ударили URL адреса.

Следващата стъпка

Сега ще извършим друга операция, наречена GET. Ще се опитаме да извлечем същия запис, който току-що създадохме.

За операцията GET не се изисква тяло или полезен товар. Тъй като вече имаме заявка за пример, използвайки метода PUT, всичко, което ни е необходимо, е да променим метода на GET.

След като сме сменили на GET, ще включим услугата отново. Както можете да видите на изображението по-долу, ние точно получихме това, което преминахме и по този начин работи POSTMAN.

Актуализация: Допълнителна информация

Какво е API?

API (Application Programming Interface) е jar файл, който съдържа няколко метода и интерфейси за извършване на определено действие.

Вижте примера по-долу и екранна снимка:

1. Създайте метод sum, който добавя две променливи и връща сумата от две променливи.
2. След това създайте клас на калкулатор, който съдържа няколко други метода като събиране, изваждане, умножение, деление и т.н. Може да има и някои помощни класове. Сега комбинирайте всички класове и интерфейси и създайте jar файл, наречен Calculator.jar, и след това го публикувайте. Използвайте API на калкулатора за достъп до методите, присъстващи вътре.
3. Някои API са с отворен код (Selenium), които могат да бъдат редактирани, а други са лицензирани (UFT), които не могат да бъдат редактирани.

Предложено четене => Най-добрите инструменти за управление на API

Как точно се извикват тези методи?

Разработчиците ще изложат интерфейс, платформа за извикване на API на калкулатора и ние създаваме обекта на класа на калкулатора и извикваме метода sum или който и да е метод.

Да предположим, че този файл calculator.jar е създаден от някаква компания и те използват тази помощна програма чрез интерфейс на потребителския интерфейс, след това тестваме това приложение на калкулатора с помощта на потребителския интерфейс и го автоматизираме с помощта на QTP / Selenium и това се нарича Тестване на предния край.

Някои приложения нямат потребителски интерфейс, поради което за достъп до тези методи ние създаваме обект от класа и предаваме аргументите за тестване и това се нарича Back-End тестване . Изпращането на заявката и връщането на отговора ще стане чрез JSON / XML файлове.

Вижте диаграмата по-долу:

какво прави c ++

Пощенски клиент

• POSTMAN е REST клиент, използван за извършване на вътрешно API тестване.
• В POSTMAN предаваме извикването на API и проверяваме отговора на API, кодовете на състоянието и полезния товар.
• Swagger е друг HTTP клиентски инструмент, при който създаваме API документация и чрез swagger също можем да ударим API и да получим отговор.
• Вижте връзката https://swagger.io/
• Можете да използвате Swagger или POSTMAN за тестване на API и зависи от компаниите какъв клиент да използвате.
• В POSTMAN използваме предимно повиквания GET, POST, PUT и DELETE.

Как да изтеглите клиента на POSTMAN?

Отворете Google Chrome и изтеглете приложението POSTMAN, налично в магазина за приложения на Chrome.

Обадете се на REST API с помощта на POSTMAN Client

В POSTMAN имаме много методи, но използваме само GET, PUT, POST и DELETE

• ПОСТ - Тази покана създава нов обект.
• ВЗЕМЕТЕ - Това обаждане изпраща заявката и получава отговора.
• СЛАГАМ - Този разговор създава нов обект и актуализира съществуващия обект.
• ИЗТРИЙ - Това повикване изтрива съществуващия обект.

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

Предлагат се и други клиенти като SOAP UI, който е REST и SOAP клиент, напреднали REST клиенти като JMeter може да извиква API-тата директно от браузъра. POSTMAN е най-добрият инструмент за извършване на POST и GET операции.

Прочетете също => Списък на задълбочените уроци за SoapUI

Изпратете заявка и получете отговор в POSTMAN Client:

За целите на теста използваме предоставения API тук .

Проверете всяко CRUD повикване в клиента на POSTMAN, като използвате API, предоставен от фиктивния сайт.

При тестване на API ние основно потвърждаваме следните точки:

• Кодовете за състояние на отговора, вижте wiki страница за детайли.
• Съобщението за отговор и тялото на отговора JSON.
• При тестване на API първо помолете разработчика да даде URL адреса на крайната точка. Вижте този URL адрес на крайната точка https://reqres.in/.

# 1) ПОЛУЧЕТЕ обаждане

Изпраща заявката и получава отговора.

Стъпки за тестване на REST API:

• Подайте https://reqres.in//api/users?page=2 (? е параметър на заявката, който филтрира резултата, като отпечатва цялата информация на потребителя на страница 2, параметърът на заявката зависи от разработчика, как ще определи) като URI в клиента на POSTMAN.
• Параметърът на заявката е дефиниран от (?), А параметърът на пътя - (/).
• Изберете метода GET.

• Предоставете заглавки (ако е необходимо) като User-Agent: „Софтуер“.

• Щракнете върху бутона ИЗПРАТИ.
• Ако API работи добре, в отговор получаваме:
  • Състояние 200 - ОК, това означава, че отговорът е получен успешно.
  • Отговор JSON полезен товар.
  • Низово съобщение

• Друг Пример на GET METHOD, където търсихме информация за конкретен потребител, т.е.потребителски id = 3. Въведете URI = https://reqres.in/api/users/3

• Ако няма данни за нашето търсене, получаваме празно JSON и съобщение за състояние 404.

# 2) POST повикване

Създайте нов потребител или обект.

Стъпки за изпълнение:

• Изберете POST от падащото меню и използвайте този URL адрес на услугата „https://reqres.in/api/users/100“
  
• Отидете в Body -> изберете RAW -> Докато предаваме JSON.
• Изберете JSON от падащото меню и поставете скрипта за полезен товар.
• Предайте този полезен товар {„name“: „Morpheus“, „job“: „leader“}

• JSON започва с фигурни скоби и съхранява данни във формат ключ, стойност.
• Предайте типа съдържание на заглавката = application / json.
• Натиснете бутона ИЗПРАТИ.

• При успешна заявка получаваме отговора по-долу:
  • Състояние 201 - Създаден, отговорът е получен успешно.
  • Отговор полезен товар
  • Хедър

# 3) PUT Call

Актуализира или създава нов обект.

Стъпки за създаване на PUT повикване:

• Използвайте този URL адрес на услугата „https://reqres.in/api/users/206“ и полезен товар {„name“: „Morpheus“, „job“: „Manager“
• Отидете на клиента на POSTMAN и изберете метод PUT -> Отидете в Body -> Select RAW> преминете JSON и изберете JSON от падащото меню и поставете скрипта за полезен товар.
• JSON започва с къдрави скоби и съхранява данни във формат ключ-стойност.
• Натиснете бутона ИЗПРАТИ, за успешна заявка ще получите отговора по-долу.
  • Състояние 200 - Добре, отговорът е получен успешно.
  • Отговор полезен товар
  • Хедър
  • Работата е актуализирана до „мениджър“

# 4) Изтриване на повикване

• Изтрийте потребителя, използвайте този URL адрес на услугата „/ api / users / 423“ и този полезен товар {„name“: „Naveen“, „job“: „QA“}.
• Отидете на POSTMAN и изберете DELETE метод, полезният товар не се изисква.
• Изтрива потребителски id = 423, ако е наличен в системата.
  • Състояние 204 - Няма съдържание, отговорът е получен успешно.
  • Не е получен полезен товар, потребителският идентификатор е изтрит.
  • Хедър

Предизвикателства при API тестване

• Тестовите случаи трябва да бъдат проектирани по такъв начин, че да покриват тестовото покритие.
• Проектирането на тестови случаи е лесно, когато API носи по-малко параметри, но сложността се увеличава, когато броят на параметрите е голям.
• Редовно актуализирайте тестовото покритие с промяна в бизнес изискванията. Ако се добави нов параметър, увеличете комплекта тестови снопове
• Правилно извикване на API за секвениране.
• Изследвайте граничните условия и производителност.

Заключение

В този урок обсъдихме важните насоки за започване на работа с инструмента за тестване на API на Postman. Научихме се да инсталираме инструмента Postman като самостоятелно приложение и обсъдихме как можем да създадем проста заявка и да разгледаме генерирания отговор.

Видяхме как да се придвижваме до различните части на информацията за отговора, както и как да преглеждаме и извличаме заявките от раздела история.

Вярваме, че досега можете да извършите успешна операция с API. Успешната работа с API не означава копиране и поставяне на цялото тяло, заглавки и други необходими блокове и успешното изпълнение на теста.

Става въпрос за това колко удобно ви е да пишете собствения си JSON, да навигирате до всяко конкретно поле в JSON с помощта на ключа на документа или параметрите, да разбирате масиви в JSON и т.н.

Клиентският инструмент POSTMAN се използва за извършване на back-end тестване и главно за извършване на GET, PUT, POST, DELETE повиквания.

От този урок научихме как да ударим обажданията от клиента POSTMAN и как да проверим отговора, който получаваме обратно от сървъра, а също така обхванахме предизвикателствата при тестване на API.

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

В нашия предстоящ урок ще научим как да използваме инструмента Postman за Diff API формати!

PREV Урок | СЛЕДВАЩ урок

Препоръчително четене

• Урок за Parasoft SOAtest: Инструмент за тестване на API без скриптове
• Урок за API тестване: Пълно ръководство за начинаещи
• Най-добри инструменти за тестване на софтуер 2021 г. (Инструменти за автоматизация на QA теста)
• Урок за деструктивно изпитване и безразрушително тестване
• Функционално тестване срещу нефункционално тестване
• Урок за инструмент за тестване на достъпност на WAVE
• Урок за тестване на достъпността (Пълно ръководство стъпка по стъпка)
• Урок за тестване на SOA: Методология за тестване за архитектурен модел на SOA