Что такое API

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

Например, Twitter предлагает публичный API с множеством полезных конечных точек, которые связаны определенными правилами. Одна из доступных конечных точек помогает автоматически просматривать твиты. Существует ограничение использования этой конечной точки. Оно устанавливает, что с помощью Twitter API можно просматривать не более 900 твитов каждые 15 минут.

Make хорош в зерокодинге. Бесплатный вебинар «IT-стартап на зерокоде» поможет в него углубиться, а также погрузиться в IT в 10 раз быстрее и дешевле!

Как использовать модуль «Вызов API»

«Вызов API» — это дверь к конечным точкам API, которых пока что нет в Make. Такая функция важна по одной причине: она позволяет получать доступ к новым конечным точкам по мере их выпуска приложениями, имеющими API. В общем не придется ждать, пока команда Make создаст новые модули для новых конечных точек.

Если нужно использовать недавно выпущенную конечную точку API прямо сейчас, продукт «Вызов API» будет работать до тех пор, пока соответствующая конечная точка не будет официально запущена.

На данный момент этот модуль доступен в самых популярных приложениях, таких как Shopify, Airtable, Google Sheets, Twitter и Slack.

Чтобы он заработал, необходимо вручную ввести в поля модуля следующие данные:

  • конечная точка API (т.е. URL-адрес)
  • версия API
  • строка запроса
  • и все остальные необходимые параметры для успешного вызова API

Пример 1. Создание нового API на примере Shopify

Shopify является крутой платформой (по сути, магазином в Интернете) для продажи своих товаров. Конечная точка, которую мы будем создавать, позволит получить список заказов из магазина Shopify.

Например, с информацией, доступной в конечной точке, мы заполним поля модуля «Вызов API» так:

  • URL-адрес: orders.json
  • тип метода запроса: GET
  • строка запроса будет состоять из одного элемента с параметрами: key = status / value = any

После заполнения всех полей жмем «OK». Теперь можно добавить модуль Google Sheets, создать сценарий Make и отправить все заказы Shopify в электронную таблицу.

Пример 2. Создание API для получения количества продуктов на Shopify

Сейчас мы используем модуль «Вызов API» для получения количества товаров. Естественно, для выполнения этого действия существует доступная конечная точка Shopify API.

1. Сначала определяем URL-адрес запроса. После нужно указать путь относительно полного URL-адреса конечной точки, то есть, ввести products/count.json.

2. В модуле «Вызов API» вводим эти данные в соответствующее поле.

3. Далее указываем версию API, к которой делаем запрос (она отображается в URL-адресе конечной точки).

4. Наконец, выбираем метод запроса. В руководстве Shopify API он указан, как «GET», именно так и пишем.

Все, модуль для получения количества товаров настроен! Чтобы проверить его работоспособность, запустите сценарий Make и посмотрите на результат.