Иногда подъем по лестнице веб-разработки может быть трудным. Всегда кажется, что есть новое слово, которое вы слышите через день.

Теперь вы снова слышите об API. Это заставляет вас задаться вопросом: «Что, черт возьми, такое API?».

Вздох. Я понимаю ваше разочарование.

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

В этой статье я объясню, что такое API, и использую JSONplaceholder, чтобы показать использование API.

Что такое API?

Интерфейс прикладного программирования (API) — это инструмент, который позволяет вашей программе взаимодействовать с другими приложениями. Да, я знаю, что это не дает вам понять, что такое API.

Давайте далее разберем это на примере. Представьте, что вы живете в древние времена и являетесь лидером королевства. Приходит что-то важное, и вам нужно отправить сообщение в соседнее королевство. Вы отправляете своего королевского посланника в это королевство со своим сообщением, ожидая ответа. Через три дня посланник возвращается. Он приносит вам сообщение из другого королевства.

В приведенном выше примере вышеприведенный мессенджер — это API.

Теперь мы можем видеть, что API — это средство отправки информации туда и обратно. Да, это так просто.

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

В качестве примера из реальной жизни можно щелкнуть вкладку «Избранное», чтобы просмотреть все ваши любимые твиты. Когда вы нажимаете на эту вкладку, приложение Twitter отправляет запрос в API, запрашивая ваши любимые твиты.

Что такое запросы API и конечные точки?

Проще говоря, запрос API отправляет сообщение на сервер с просьбой о чем-то взамен. Запросы API обычно выполняются через конечные точки.

Проще говоря, конечные точки — это «маршруты» для получения конкретной информации. Эти маршруты представляют собой URL-адреса, которые мы размещаем в наших браузерах. Большинство маршрутов будут состоять из названия веб-сайта, за которым следует «путь».

Например, предположим, что имя веб-сайта «https://yippy.com». Теперь предположим, что путь — «/west», а другой — «/east». Это даст нам «https://yippy.com/west» или «https://yippy.com/east». Это то, что мы называем конечными точками.

Каждая конечная точка будет давать нам разные типы ответов.

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

Что такое методы запроса API?

Давайте дадим одному из королевств имя. Даем ему «Думаса».

В зависимости от того, какую информацию вы хотите, вы скажете своему мессенджеру сделать разные вещи. Вы можете сказать им разведать местность или проверить, не планируют ли они войну.

Мы видим, что методы запроса API — это действия, предпринимаемые при отправке сообщения/запроса. У нас есть четыре основных:

  • GET: для получения информации от конечной точки
  • POST: создание/создание данных в этой конечной точке.
  • PUT: используется для обновления данных, которые мы сделали.
  • УДАЛИТЬ: используется для удаления данных, которые мы сделали.

Со всеми этими знаниями мы собираемся заняться практическими делами, используя JSONplaceholder.

Что такое заполнитель JSON?

JSONplaceholder — это простой и бесплатный поддельный API. У него есть разные конечные точки, которые дают нам поддельные сообщения, задачи, комментарии и т. д.

Если вам нужен поддельный API, чтобы поиграть с ним, вы должны проверить его.

Теперь к пикантной части.

Конечные точки в JSONplaceholder API

Для этого раздела полезно скачать Почтальон, чтобы вы могли следить за ним. Не волнуйтесь, вам не нужно регистрироваться, чтобы использовать его. Тсссс. Это бесплатно.

В JSONplaceholder есть 8 конечных точек. URL-адрес, который мы собираемся использовать, — https://jsonplaceholder.typicode.com.

  1. ПОЛУЧИТЬ /posts

Во входных данных вы должны ввести https://jsonplaceholder.typicode.com/posts.

Нажмите Отправить. В разделе «Тело» под ним это должно появиться.

2. ПОЛУЧИТЬ /posts/{post_id}

В поле ввода введите https://jsonplaceholder.typicode.com/posts/2. Вы можете поставить любое число по вашему выбору от 1 до 60.

Нажмите Отправить. В разделе «Тело» под ним это должно появиться.

3. ПОЛУЧИТЬ /posts/{post_id}/comments

В поле ввода введите https://jsonplaceholder.typicode.com/posts/2/comments.

Нажмите отправить. Это приведет к такому результату:

4. ПОЛУЧИТЬ /comments?postId={post-id}

В поле ввода введите https://jsonplaceholder.typicode.com/comments?postId=2. Нажмите отправить. Это должно вывести:

5. ОТПРАВИТЬ /сообщения

Измените тип метода на «POST». Затем в поле ввода введите https://jsonplaceholder.typicode.com/posts.

Под вводом URL перейдите на вкладку «Тело». Затем нажмите «x-www-form-urlencoded».

Вы увидите раздел с «Ключ» и «Значение». Введите следующую информацию.

Нажмите отправить. Это должно вывести:

6. ПОСТАВЬТЕ /posts/{post-id}

Измените тип метода на «PUT». Затем в поле ввода введите https://jsonplaceholder.typicode.com/posts/3.

В области «Ключ и значение» введите следующую информацию:

Нажмите отправить. Это должно вывести:

7. ИСПРАВЛЕНИЕ /posts/{post-id}

Измените тип метода на «PATCH». Затем в поле ввода введите https://jsonplaceholder.typicode.com/posts/3.

В области «Ключ и значение» снимите галочки со всех ключей, кроме «название».

Нажмите отправить. Это должно вывести:

8. УДАЛИТЬ /posts/{post-id}

Измените тип метода на «УДАЛИТЬ». Затем в поле ввода введите https://jsonplaceholder.typicode.com/posts/4. Нажмите отправить. Это должно вывести:

Вот и все.

Теперь вы знаете, как работать с API. Яааааааааааааааааааааааааааааааа