Термины вкатуна. API⁠⁠

Что такое API?

💡 Определение

API (Application Programming Interface, программный интерфейс приложения) — это набор правил, протоколов и инструментов, которые позволяют разным программам взаимодействовать друг с другом.
Грубо говоря, API — это «посредник», который передает запросы от одной системы к другой и возвращает ответы.

🐣 Пример из жизни:

Представьте, что вы в ресторане. Вы (клиент) делаете заказ официанту (API), а он передает его повару (серверу). Вы не видите, как готовится блюдо, но получаете результат. Так и API скрывает сложность внутренней логики, предоставляя простой интерфейс для взаимодействия.

👀 Как работает API?

1. Запрос (Request):
   Одна программа отправляет запрос к API (например: «Дай список пользователей»).

2. Обработка:
   API проверяет запрос, обращается к серверу или базе данных.

3. Ответ (Response):
   API возвращает результат в формате, который понятен запрашивающей стороне (чаще всего JSON или XML).

Пример запроса к веб-API:

GET https://api/users

Пример ответа:

{ "users": [ { "id": 1, "name": "Светлана" }, { "id": 2, "name": "Василий" } ] }

👾 ВидыAPI

• REST — самый популярный тип, использует HTTP-методы (GET, POST, PUT, DELETE).

• SOAP — протокол на основе XML, чаще применяется в корпоративных системах.

• GraphQL — позволяет клиенту запрашивать только нужные данные.

🔧 Инструменты для работы с API

• Postman — тестирование и отправка запросов.

• Swagger (OpenAPI) — автоматическая документация API.