В этой статье я напишу об API и о том, как их тестировать с помощью Postman.

Так что вы, должно быть, слышали об API, если вы разработчик, и я буду подробно обсуждать его.

Что такое API и как он работает?

Интерфейс прикладного программирования или API — это конвейер для передачи данных из клиентского приложения на сервер и наоборот из requests и responses или, другими словами, API действует как средство связи между клиентом и сервером по сети. Представьте, что вы пришли в свой любимый ресторан, сидя за столиком вы зовете официанта заказать что-то (скажем, пиццу), после чего официант передает ваш заказ шеф-повару. Теперь есть две возможности: либо вы получаете свою пиццу, либо официант возвращается с сообщением: «Извините, сэр, пиццы, которую вы только что заказали, в настоящее время нет в наличии, пожалуйста, закажите что-нибудь еще».

Здесь вы client-side application, chef — это сервер, а waiter — это API, который передает ваш request на сервер и приносит вам response.

Зачем нам API?

Рассмотрим ситуацию, когда вы создаете приложение, такое как Uber, и у него будут некоторые базовые службы, такие как authentication, maps для службы определения местоположения, email service для отправки счетов и информационных бюллетеней или payment service для приема платежей. Теперь вы можете получить доступ ко всем этим службам через API, такие как Google maps службы определения местоположения auth0 для передачи аутентификации amazon sqs для электронной почты и stripe для платежей. Все, что я хочу сказать, это то, что вы можете получить доступ к любому программному сервису черезAPI's, которому не нужно создавать все эти сервисы с нуля. Кроме того, использование API будет более рентабельным, чем создание сервиса с нуля. И поверьте мне, для всего есть API, все, что вам нужно сделать, это реализовать его.

Что такое Postman и почему мы должны его использовать?

Postman — это API инструмент для совместной разработки, который позволяет легко создавать, тестировать, разрабатывать и использовать API через замечательный UI. И он используется глобальными и ведущими организациями, такими как PayPal, Uber и т. д. Так что тестируйте любой API, вы можете делиться своими работами или разрабатывать API со своей командой одновременно, используя общедоступное или приватное рабочее место. Вы даже можете писать тесты или проверять наличие проблем с безопасностью и многое другое.

Запрос и ответ в деталях

Как я упоминал ранее, как работает API, теперь давайте подробно разберемся с request и responses. Говоря о request, когда вы что-то ищете в Google, вы фактически отправляете запрос серверу Google, передавая запрос. Посмотрите на изображение ниже, вы можете видеть, что URL-адрес — https://www.google.com/search?q=hello, здесь https:\\ — это протокол для вашего запроса, www.google.com — это адрес server, \search — это endpoint, а ?q=hello — ваш query.

Предположим, учитель попросил Рама принести ему книгу для библиотеки. Здесь Asking — протокол запроса, ram — имя хоста для сервера, library — конечная точка, а book — запрос.

Методы запроса

GET - Получить информацию

POST-отправить информацию

PUT/PATCH - Обновить информацию

УДАЛИТЬ - Удалить информацию

Теперь, если вы что-то запросили, вы обязательно получите ответ с кодом состояния. Если упростить, ваши результаты поиска будут под вашей ответственностью. API может возвращать покой во многих формах, таких как Html, XML, JSON и т. д. и самое главное, что приносит ответ, — это код состояния. Коды состояния помогают нам понять тип нашего ответа. Предположим, что если вы отправляете запрос GET, вы можете получить данные с кодом состояния 200, что означает успех, или можете получить 404, что означает не найдено, или если вы отправите PUT или POST или DELETE, вы можете получить 201 для созданного 204 контента нет или 500 внутренней ошибки сервера.

Начать использовать почтальон

Создать учетную запись почтальона

Создать рабочее пространство (имеется в виду создание проекта)

Перейдите на главную›Рабочие области›Создать рабочую область

Назовите свое рабочее пространство › Добавьте сводку › выберите видимость › нажмите Create Workspace

Создать коллекцию

Под коллекцией понимается группа сохраненных запросов. Мы можем создать новую коллекцию или просто fork (означает копирование) коллекции в нашу рабочую область. Чтобы создать новую коллекцию в своей рабочей области, щелкните левой кнопкой мыши на + › добавьте имя в свою коллекцию › нажмите :, чтобы добавить новый запрос.

Разветвить коллекцию

посетить коллекцию › нажмите ... › прокрутите вниз и выберите create a fork› добавьте метку и выберите местоположение рабочей области › нажмите create fork

Get

getthe request используется, когда мы хотим получить некоторые данные из API. Предположим, я спрошу вас, как зовут? вы ответите мне своим именем (скажем, меня зовут Джон). В этом примере вы — API, мой вопрос — запрос на получение, а ваш ответ — ответ. Теперь давайте выполним это задание в реале.

Откройте почтальона, нажмите на вкладку +, чтобы создать новый запрос, а затем выберите Получить запрос в раскрывающемся списке и вставьте этот URL в местозаполнитель Enter request URL, а затем нажмите Отправить.

Post

post запрос используется, когда мы хотим отправить данные на сервер с помощью API. Предположим, вы написали что-то на бумаге, поэтому в данном случае то, что вы написали, — это данные, а карандаш, который вы используете, — это API, а бумага — это сервер.

Теперь снова в почтальоне, затем вставьте тот же URL-адрес, на этот раз выберите запрос на публикацию из раскрывающегося списка, затем щелкните body › raw ›json и напишите содержимое JSON в заполнителе и нажмите кнопку отправки.

"userId": 697,
    "id": 10,
    "title": "post request ",
    "body": "this request is created by kk"
}

Put

put запрос используется, когда мы хотим обновить какие-либо данные, которые мы отправили ранее на сервер, используя API. Предположим, вы написали эссе на бумаге и теперь хотите что-то в ней обновить, в этом случае вашим карандашом будет API, а бумага будет сервером, и вы сможете обновлять что угодно на бумаге.

Теперь снова в почтальоне, затем вставьте URL, на этот раз выберите put для запроса из раскрывающегося списка, затем нажмите body › raw › json и напишите какой-нибудь контент JSON в заполнителе, на этот раз давайте изменим контент.

{
   "title":"This title is updated" 
}

Delete

Запрос delete используется для удаления некоторых данных с сервера с помощью API. Учитывая последний пример, после написания эссе теперь вы хотите стереть его с помощью ластика, в этом случае ваша статья будет сервером, а ластиком будет API. Теперь снова в почтальоне отправим запрос на удаление на этот URL,