📄️ Ликбез по понятиям: REST, API, HTTP
В чём разница между REST и API?
📄️ REST. Краткий обзор
REST
📄️ HTTP. Что нужно знать аналитику
HTTP (HyperText Transfer Protocol) — это, если дословно, протокол передачи гипертекста. Простыми словами, гипертекст – это текст + теги. Сегодня HTTP – самый популярный протокол интернета и в целом интеграций через API.
📄️ HTTP. Краткие советы по использованию протокола
Основные рекомендации
📄️ HTTPS и его отличие от HTTP
HTTPS – это защищённая версия протокола HTTP, которая шифрует передаваемые данные между клиентом и сервером. HTTPS не является отдельным протоколом. Это обычный HTTP, который работает через шифрованный протокол TLS. В отличие от HTTP с TCP-портом 80, для HTTPS по умолчанию используется TCP-порт 443.
📄️ Версионирование REST API
Версионирование API — это поддержка в рабочем состоянии нескольких версий одного и того же метода. Версионирование API позволяет соблюдать требование обратной совместимости, вносить изменения без нарушения работы потребителей.
📄️ Webhook. Что это такое и когда используется
Вебхук — это способ оповещения клиента о произошедшем в системе событии с помощью пользовательских обратных вызовов по HTTP. Вебхук запускается, когда в системе происходит какое-то событие. Например, человек написал комментарий на сайте. Когда происходит такое событие, сервер создает HTTP-вызов и отправляет его на адрес, который клиент указал для получения вебхуков.
📄️ Работа со списками данных в REST API: сортировка, фильтрация, пагинация
Сортировка
📄️ Модель зрелости REST API Леонарда Ричардсона
Модель зрелости REST API Леонарда Ричардсона — концепция, которая оценивает уровень соответствия API принципам REST.
📄️ Советы по проектированию REST API
1. Множественное число для коллекций