Водич за ПОСТМАН: Испитивање АПИ-ја помоћу ПОСТМАН-а

postman tutorial api testing using postman

Овај водич по корак по корак објашњава тестирање АПИ-ја помоћу ПОСТМАН-а, укључујући основе ПОСТМАН-а, његове компоненте и узорак захтева и одговора:

Погледали смо најчешће питане Питања за интервју за АСП.Нет и Веб АПИ у нашем претходном упутству. Пролазећи кроз овај водич, научићете како приступамо тестирању АПИ-ја путем ПОСТМАН-а за било који дати УРЛ.

Поштар је врло једноставан и интуитиван алат или апликација за тестирање АПИ-ја. Свака компонента у ПОСТМАН-у је веома важна јер има свој значај.

=> Овде прочитајте комплетну серију тестирања АПИ-ја .

питања и одговори на интервјуу за осигурање квалитета пдф

Списак свих туторијала за поштаре у овој серији

Туториал # 1: Увод за поштара (овај водич)
Туториал # 2: Како се користи поштар за тестирање различитих АПИ формата
Туториал # 3: Поштар: Променљиви опсези и датотеке из окружења
Туториал # 4: Збирке поштара: увоз, извоз и генерисање узорака кода
Водич бр. 5: Аутоматизација валидација одговора тврдњама
Лекција # 6: Поштар: Претходни захтев и скрипте за захтев
Туториал # 7: Постман Адванцед Сцриптинг
Туториал # 8: Поштар - интеграција командне линије са Невман-ом
Туториал # 9: Поштар - шаблони за извештавање са Невман-ом
Водич бр. 10: Поштар - Стварање АПИ документације
Туториал # 11: Питања за интервју са поштаром

Преглед лекција у серији Поштари

Шта ћете научити:

• ПОШТАР Увод
• Инсталација ПОСТМАН-а
  • Поштар Нативе Апп
  • Водич за брзу инсталацију поштара
  • Грађевински блокови ПОШТАНА
    • # 1) Захтев
    • # 2) Збирка
    • # 3) Животна средина
  • Спремање захтева у колекцију
• Узорак захтева и одговора
• Ажурирање: Додатне информације
  • Шта је АПИ?
  • Клијент ПОСТМАН
    • Како преузети ПОСТМАН клијента?
  • Позовите РЕСТ АПИ-је помоћу ПОСТМАН клијента
    • # 1) ГЕТ Цалл
    • # 2) ПОСТ позив
    • # 3) ПУТ позив
    • # 4) Избриши позив
  • Изазови у АПИ тестирању
• Закључак
  • Препоручено читање

ПОШТАР Увод

ПОСТМАН је АПИ клијент који се користи за развој, тестирање, дељење и документовање АПИ-ја. Користи се за позадинско тестирање где уносимо УРЛ крајње тачке, шаље захтев серверу и прима одговор натраг са сервера. Иста ствар се може постићи и путем АПИ шаблона као што је Сваггер. И у Сваггеру и у ПОСТМАН-у не морамо да градимо оквир (за разлику од Парасофта) да бисмо преузели одговор из услуге.

Ово је главни разлог због којег програмери и инжењери аутоматизације ПОСТМАН често користе како би осигурали да услуга ради и ради заједно са верзијом израде АПИ-ја који је постављен у регион.

У основи помаже у погађању крајњих тачака АПИ-ја тако што брзо креира захтеве према АПИ спецификацији и сецира различите параметре одговора попут статусног кода, заглавља и самог тела одговора.

Ево видео упутства:

Поштар нуди пуно напредних функција попут:

• АПИ развој.
• Постављање Моцк крајњих тачака за АПИ-је који су још увек у фази израде.
• АПИ документација.
• Тврдње за одговоре примљене из извршења крајње тачке АПИ-ја.
• Интеграција са ЦИ-ЦД алатима као што су Јенкинс, ТеамЦити итд.
• Аутоматизовање извршавања АПИ тестова итд.

Сада смо прошли формално представљање алата, пређимо на део за инсталацију.

Инсталација ПОСТМАН-а

Поштар је доступан у две опције.

1. Као апликација за Цхроме (ово је већ застарело и нема подршку програмера Постман)
2. Изворна апликација за различите платформе као што су Виндовс, Мац ОС, Линук итд.

Како су Цхроме апликације застареле и уско су повезане са Цхроме прегледачем (у неколико случајева стварна верзија прегледача), фокусираћемо се углавном на матичну апликацију која нам даје већу контролу и има мање спољних зависности.

Поштар Нативе Апп

Постман Нативе апликација је самостална апликација која је доступна за преузимање у различитим ОС платформама као што су Виндовс, Мац ОС, Линук итд. Ово се може преузети као и свака друга апликација у зависности од корисничке платформе.

Процес инсталације је такође прилично једноставан. Једноставно морате двапут кликнути на преузету инсталацију (за Виндовс и Мац) и следити упутства.

Када је инсталација успешна, једноставно отворите апликацију Поштар да бисте започели.

Видећемо како да креирамо једноставан захтев за било који доступан АПИ отвореног кода и видећемо разне компоненте захтева и одговора примљене када се захтев извршава помоћу апликације Поштар.

Топло се препоручује да се пријавите / пријавите у апликацију Поштар помоћу постојећег налога е-поште. Пријављени рачун чува све поштанске колекције и захтеве који су сачувани током сесије и осигурава да захтеви и даље буду доступни за рад када се исти корисник следећи пут пријави.

Молимо погледајте Белешка одељак да бисте добили детаље о јавно доступној крајњој тачки лажног АПИ-ја.

Илустроваћемо пример ГЕТ захтева за ово УРЛ која би вратила 100 постова као одговор на ЈСОН.

Почнимо и погледајмо кораке које треба следити:

# 1) Отворите апликацију Поштар (Ако већ нисте пријављени са постојећим или новим налогом, прво се пријавите са одговарајућим акредитивима).

Доље је дата слика почетног екрана поштарског корисничког интерфејса:

#два) Направите нови захтев и попуните детаље према крајњој тачки коју ћемо користити за тест или илустрацију. Испробајмо захтев за преузимање РЕСТ АПИ крајње тачке хттп://думми.рестапиекампле.цом/апи/в1/емплоиеес

# 3) Када се својства захтева попуне, притисните СЕНД да бисте извршили захтев на серверу који хостује крајњу тачку.

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

Погледајмо сваку од њих детаљно.

Када се одговор доврши, подразумевано се бира и приказује картица тела одговора. Остали параметри за одговор попут шифре статуса одговора, времена потребног за завршетак захтева, величине корисног терета приказани су одмах испод заглавља захтева (као на доњој слици).

Да бисте добили прецизне детаље о параметрима одговора, као што су величина одговора и време одзива, можете једноставно прећи курсором изнад сваке од тих вредности, а поштар ће вам приказати детаљан приказ са детаљнијим детаљима за свако од тих својстава.

На пример, за време захтева - даље ће га сецирати на појединачне компоненте попут времена повезивања, времена сокета, ДНС претраживања, руковања итд.

Слично томе, за величину одговора, показат ће вам рашчламбу колике су величине заглавља и која је стварна величина одговора.

Погледајмо сада друге картице са одговорима, тј. Колачићи и заглавља. У веб свету, Колачићи имају велику важност у смислу вођења искустава на страни клијента и мноштва информација повезаних са сесијама како би добили све информације о колачићима враћеним са сервера. Можете да пређете на картицу колачића и видите ово.

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

Овде је важно напоменути да су сви захтеви које упутите серверу ускладиштени у Историји поштара за будућу употребу (картица Историја је доступна на левој бочној табли апликације).

Ово помаже у спречавању стварања захтева сваки пут када треба да добијете одговор на исти захтев, а такође помаже у избегавању свакодневних задатака. Ако је потребно, можете се позвати на прошле захтеве (као и на одговоре) у будућем временском периоду.

Белешка: Да бисмо илустровали узорке захтева и одговора, користићемо јавно доступне лажне АПИ сервере који ће омогућити израду свих врста ХТТП захтева и који враћају важећи ХТТП одговор.

Да наведемо само неке, користићемо доленаведене лажне АПИ крајње тачке као референцу:

1. Пример одмора АПИ
2. ЈСОН чувар места Типични код

Водич за брзу инсталацију поштара

ПОСТМАН је отворени алат и доступан је свима који сурфују Интернетом. Можете следити кораке у наставку и инсталирати ПОСТМАН алат у ваш локални рачунар.

Корак 1: Отвори Гоогле и потражите алатку ПОСТМАН. Добићете доњи резултат претраге. Затим можете кликнути на Преузми апликацију поштара и бићете преусмерени на веб локацију гетпостман.

Иначе, до овога можете директно да дођете УРЛ да бисте добили алатку ПОСТМАН.

Корак 2: Изаберите верзију ПОСТМАН-а на основу вашег оперативног система. У нашем случају ћемо користити ПОСТМАН за Виндовс ОС. Штавише, користимо Виндов-64 бит, па ћемо преузети и инсталирати ПОСТМАН за 64 бит.

Корак 3: Након што кликнете на дугме Преузми, датотека постман.еке ће се преузети у ваш локални. Кликните на ту датотеку. Инсталација је једним кликом, баш као и свака друга апликација која ће вам омогућити да инсталирате додатак ПОСТМАН за свој прегледач.

Корак 4: Након што инсталирате апликацију, кликните на апликацију (која мора бити постављена на радну површину). Као што можете видети на доњој слици, имамо шест различитих ентитета за које ће вам у основи требати три градивна елемента, тј. Захтев, прикупљање и окружење, о чему ће бити речи у следећем одељку.

То је то!! Успешно смо инсталирали и покренули апликацију ПОСТМАН.

Грађевински блокови ПОШТАНА

ПОСТМАН има низ грађевинских блокова, али у нашу сврху разговараћемо о три главна грађевинска блока која су од суштинске важности за сваку ПОСТМАН операцију.

Ова три главна блока су:

# 1) Захтев

Захтев није ништа друго до комбинација комплетне УРЛ адресе (која укључује све параметре или кључеве), ХТТП заглавља, тела или корисног терета. Ови атрибути заједно чине захтев. ПОСТМАН вам омогућава да сачувате захтев, а ово је добра карактеристика апликације која нам омогућава да исти захтев користимо онолико пута колико желимо.

Кликните на Ново -> Захтев

# 2) Збирка

Мора да постоји нешто где ћете сачувати своје групне захтеве. Ово је сценарио када колекција долази у слику. Можемо рећи да је колекција спремиште у које можемо да сачувамо све своје захтеве. Генерално се захтеви који погађају исти АПИ чувају у истој колекцији.

Кликните на Ново -> Колекција.

# 3) Животна средина

Окружење је регион у којем ће се одвијати све ваше радње на АПИ-ју. То може бити ТУП, КА, Дев, УАТ или ПРОД. У сваком пројекту ће региони већ бити конфигурисани и у њему морате само да пријавите своје глобалне променљиве као што су УРЛ, ИД и лозинка токена, кључеви контекста, АПИ кључеви, кључеви докумената и тако даље.

Кликните на Ново -> Животна средина.

Спремање захтева у колекцију

Сада ћемо покушати да сачувамо узорак захтева у колекцији и користићемо исти захтев да бисмо погодили АПИ.

Корак 1: У горњем десном углу видећете дугме „+ Ново“. Кликните на ово дугме и добићете листу грађевних блокова који су приказани када сте први пут покренули апликацију.

Корак 2: Кликните на Захтев.

Корак 3: Наведите име захтева које је обавезно поље. Затим кликните на „+ Направи колекцију“.

Корак 4: Када кликнете на „+ Направи колекцију“, тражиће име (рецимо Узорак колекције). Унесите име колекције и притисните Ентер.

Корак 5: Кликните на „Сачувај у колекцији узорака“ дугме.

Узорак захтева и одговора

Овај посебан одељак ће вам пружити дубок увид у то како тестирати АПИ у ПОСТМАН-у.

Као што видите на доњој слици, имамо наш захтев који смо већ креирали (Тест фор СофтвареТестингХелп). Штавише, можете видети падајући мени (само поред УРЛ-а) који садржи глаголе или методе које подржава ПОШТАН.

Они се зову ХТТП глаголи. Покушаћемо да ажурирамо нешто помоћу методе ПУТ, а затим ћемо то добити помоћу методе ГЕТ. Претпостављам да су читаоци свесни функционалности ових ХТТП глагола који се користе у АПИ тестирању.

Сада имамо УРЛ и метод захтева. Све што нам је потребно су заглавља и носивост или тело. У неким случајевима морамо генерисати токене (на основу потреба АПИ-ја).

Прогласићемо наша ХТТП заглавља, тј. Цонтент-Типе и Аццепт. Прихватање није увек обавезно јер одлучује о формату у којем ћемо добити одговор. Подразумевано је одговор увек ЈСОН.

Нема потребе да занемарујете вредности ових заглавља, јер ће вам ПОСТМАН пружити предлоге када уносите текстна подручја кључа и вредности.

Затим ћемо прећи на следећи обавезни одељак који је Тело. Овде ћемо пружити корисни терет у облику ЈСОН-а. Свесни смо како да напишемо сопствени ЈСОН, па ћемо покушати да створимо сопствени ЈСОН.

Узорак захтева

УРЛ: хттп://ввв.моцки.ио/в2/5цд6ц3ф23000004б006061ц5

Заглавља

Тип садржаја: апплицатион / ЈСОН
Прихватити = апплицатион / ЈСОН

Тело

Сад Удри

Када имате комплетан захтев, кликните на дугме „Пошаљи“ и погледајте код за одговор. Код 200 ОК означава успешан рад. На доњој слици можете видети да смо успешно погодили УРЛ.

Следећи корак

Сада ћемо извршити још једну операцију која се зове ГЕТ. Покушаћемо да дохватимо исти запис који смо управо креирали.

За операцију ГЕТ нам није потребно тело или корисни терет. Како већ имамо свој узорак захтева који користи методу ПУТ, све што нам је потребно је да променимо методу у ГЕТ.

Када се променимо у ГЕТ, поново ћемо приступити услузи. Као што видите на доњој слици, тачно смо добили оно што смо прошли и тако функционише ПОСТМАН.

Ажурирање: Додатне информације

Шта је АПИ?

АПИ (Апплицатион Программинг Интерфаце) је јар датотека која садржи неколико метода и интерфејса за извођење одређене радње.

Погледајте доњи пример и снимак екрана:

1. Направите методу збира, која додаје две променљиве и враћа збир две променљиве.
2. Затим створите класу калкулатора која садржи неколико других метода попут сабирања, одузимања, множења, дељења и тако даље. Можда постоје и неки помоћни часови. Сада комбинирајте све класе и интерфејсе и креирајте јар датотеку названу Цалцулатор.јар, а затим је објавите. Користите АПИ калкулатора за приступ методама присутним у њему.
3. Неки АПИ-ји су отвореног кода (Селениум) који се могу уређивати, а неки лиценцирани (УФТ) који се не могу уређивати.

Предложено читање => Врхунски алати за управљање АПИ-јем

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

Програмери ће изложити интерфејс, платформу за позивање АПИ-ја калкулатора, а ми креирамо објекат класе калкулатора и позивамо методу суме или било коју другу методу.

Претпоставимо да је ову датотеку цалцулатор.јар креирала нека компанија и користе овај услужни програм путем интерфејса корисничког интерфејса, а затим тестирамо ову апликацију калкулатора помоћу корисничког интерфејса и аутоматизујемо је помоћу КТП / Селениум, а то се назива Фронт Енд Тестинг

Неке апликације немају кориснички интерфејс, па да бисмо приступили овим методама, креирамо објекат класе и прослеђујемо аргументе за тестирање и то се назива Пробно тестирање . Слање захтева и повратак одговора ће се обавити до краја ЈСОН / КСМЛ датотеке.

Погледајте доњи дијаграм:

Клијент ПОСТМАН

• ПОСТМАН је РЕСТ клијент који се користи за извођење позадинског АПИ тестирања.
• У ПОСТМАН-у прослеђујемо АПИ позив и проверавамо АПИ одговор, кодове статуса и корисни терет.
• Сваггер је још један ХТТП клијентски алат у којем креирамо АПИ документацију и помоћу свагера такође можемо да погодимо АПИ и добијемо одговор.
• Погледајте везу хттпс://сваггер.ио/
• За тестирање АПИ-ја можете користити Сваггер или ПОСТМАН, а зависно је од компанија који ће клијент користити.
• У ПОСТМАН-у углавном користимо позиве ГЕТ, ПОСТ, ПУТ и ДЕЛЕТЕ.

Како преузети ПОСТМАН клијента?

Отворите Гоогле Цхроме и преузмите апликацију ПОСТМАН која је доступна у продавници апликација Цхроме.

Позовите РЕСТ АПИ-је помоћу ПОСТМАН клијента

У програму ПОСТМАН имамо много метода, али користимо само ГЕТ, ПУТ, ПОСТ и ДЕЛЕТЕ

• ПОШТА - Овај позив ствара нови ентитет.
• ДОБИТИ - Овај позив шаље захтев и прима одговор.
• СТАВИТИ - Овај позив креира нови ентитет и ажурира постојећи ентитет.
• ИЗБРИШИ - Овим позивом се брише постојећи ентитет.

АПИ-јевима се може приступити коришћењем корисничког интерфејса попут банкарске платформе или тамо где кориснички интерфејс није доступан попут позадинских система у којима користимо РЕСТ АПИ клијента као што је ПОСТМАН.

Доступни су и други клијенти попут СОАП УИ који је РЕСТ и СОАП клијент, као што су напредни РЕСТ клијенти ЈМетер може да позове АПИ-је директно из прегледача. ПОСТМАН је најбољи алат за извођење ПОСТ и ГЕТ операција.

Такође прочитајте => Списак детаљних водича за сапунУИ

како инсталирати .бин датотеку

Пошаљите захтев и добијте одговор у клијенту ПОСТМАН:

У сврху тестирања користимо обезбеђени АПИ овде .

Проверите сваки ЦРУД позив у ПОСТМАН клијенту користећи АПИ-је које пружа лажна локација.

У АПИ тестирању углавном валидирамо следеће тачке:

• Кодови статуса одговора, погледајте вики страница за детаље.
• Порука одговора и тело одговора ЈСОН.
• У АПИ тестирању прво затражите од програмера да наведе УРЛ крајње тачке. Погледајте УРЛ ове крајње тачке хттпс://рекрес.ин/.

# 1) ГЕТ Цалл

Шаље захтев и прима одговор.

Кораци за тестирање РЕСТ АПИ-ја:

• Пасс хттпс://рекрес.ин//апи/усерс?паге=2 (? је параметар упита који филтрира резултат попут исписа свих информација о кориснику на страници 2, параметар упита зависи од програмера како ће дефинирати) као УРИ у ПОСТМАН клијенту.
• Параметар упита је дефинисан са (?), А параметар пута је (/).
• Изаберите ГЕТ метод.

• Наведите заглавља (ако је потребно) попут Усер-Агент: „Софтвер“.

• Кликните на дугме ПОШАЉИ.
• Ако АПИ ради добро, као одговор добијамо:
  • Статус 200 - ОК, то значи да је одговор успешно примљен.
  • Одговор ЈСОН корисног терета.
  • Стринг Мессаге

• Други Пример ГЕТ МЕТХОД-а, где смо тражили информације о одређеном кориснику, тј. усер ид = 3. Унесите УРИ = хттпс://рекрес.ин/апи/усерс/3

• Ако подаци нису доступни у нашој претрази, добићемо празан ЈСОН и поруку о статусу 404.

# 2) ПОСТ позив

Направите новог корисника или ентитет.

Кораци за извршење:

• Изаберите ПОСТ из падајућег менија и користите ову УРЛ адресу услуге „хттпс://рекрес.ин/апи/усерс/100“
  
• Идите на Боди -> изаберите РАВ -> Док пролазимо ЈСОН.
• Изаберите ЈСОН из падајућег менија и налепите скрипту корисног терета.
• Проследи овај терет {„наме“: „Морпхеус“, „јоб“: „леадер“}

• ЈСОН започиње коврџавим заградама и чува податке у кључу, формату вредности.
• Проследите тип садржаја заглавља = апплицатион / јсон.
• Притисните дугме ПОШАЉИ.

• На успешан захтев добијамо одговор у наставку:
  • Статус 201 - Створен, одговор је успешно примљен.
  • Одговор оптерећења
  • Заглавље

# 3) ПУТ позив

Ажурира или креира нови ентитет.

Кораци за креирање ПУТ позива:

• Користите ову УРЛ адресу услуге „хттпс://рекрес.ин/апи/усерс/206“ и корисни терет {„наме“: „Морпхеус“, „јоб“: „Манагер“
• Идите на ПОСТМАН клијента и одаберите методу ПУТ -> Идите на тело -> Изаберите РАВ> додајте ЈСОН и изаберите ЈСОН из падајућег менија и налепите скрипту корисног терета.
• ЈСОН започиње витичастим заградама и чува податке у формату кључ / вредност.
• Притисните дугме ПОШАЉИ, за успешан захтев добићете одговор у наставку.
  • Статус 200 - Ок, одговор је успешно примљен.
  • Одговор оптерећења
  • Заглавље
  • Посао је ажуриран на „менаџер“

# 4) Избриши позив

• Избришите корисника, користите овај УРЛ услуге „/ апи / усерс / 423“ и ово корисно оптерећење {„наме“: „Навеен“, „јоб“: „КА“}.
• Идите на ПОСТМАН и одаберите ДЕЛЕТЕ методу, корисни терет није потребан.
• Брише кориснички ИД = 423 ако је доступан у систему.
  • Статус 204 - Нема садржаја, одговор је успешно примљен.
  • Корисни терет није примљен, кориснички ИД је избрисан.
  • Заглавље

Изазови у АПИ тестирању

• Тест случајеви треба да буду дизајнирани тако да покривају покривеност тестом.
• Дизајнирање тест случајева је једноставно када АПИ носи мање параметара, али сложеност се повећава када је број параметара велик.
• Редовно ажурирајте покривеност тестом променом пословних захтева. Ако се дода нови параметар, повећајте пакет испитних појасева
• Правилно секвенцирање АПИ позива.
• Истражите граничне услове и перформансе.

Закључак

У овом упутству смо разговарали о важним упутама за почетак рада са алатком за тестирање Постман АПИ-ја. Научили смо да инсталирамо алатку Поштар као самосталну апликацију и разговарали смо о томе како да креирамо једноставан захтев и погледамо генерисани одговор.

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

Верујемо да до сада можете извршити успешну операцију на АПИ-ју. Успешна операција на АПИ-у не значи копирање и лепљење целог тела, заглавља и других неопходних блокова и омогућавање успешног извршења теста.

Ради се о томе колико вам је угодно писати сопствени ЈСОН, кретати се до било ког одређеног поља у ЈСОН-у уз помоћ тастера за документ или параметара, разумети низове у ЈСОН-у итд.

Клијентски алат ПОСТМАН користи се за позадинско тестирање и углавном за извођење позива ГЕТ, ПУТ, ПОСТ, ДЕЛЕТЕ.

Из овог водича научили смо како да погађамо позиве ПОСТМАН клијента и како да потврдимо одговор који добијамо са сервера, а такође смо покрили и изазове у тестирању АПИ-ја.

АПИ тестирање је веома важно за проналажење рупа у АПИ-има јер ће их хакери искористити и проузроковати финансијске губитке. АПИ тестирање делује једноставно, али требали бисмо бити врло опрезни и покушати тестирати са сваком могућом комбинацијом.

У нашем предстојећем упутству научићемо како да користимо алатку Поштар за Дифф АПИ формате!

ПРЕВ Туториал |. | СЛЕДЕЋА Лекција

Препоручено читање

• Водич за Парасофт СОАтест: Алат за тестирање АПИ-ја без скрипти
• Водич за тестирање АПИ-ја: Комплетан водич за почетнике
• Најбољи алати за тестирање софтвера 2021. године (КА Тест Аутоматион Тоолс)
• Водич за испитивање разарања и испитивања без разарања
• Функционално тестирање вс нефункционално тестирање
• Водич за алат за тестирање приступачности ВАВЕ-а
• Водич за тестирање приступачности (потпун водич по корацима)
• Водич за тестирање СОА: Методологија тестирања за модел архитектуре СОА