HTTP и API

HTTP описывает обмен сообщениями между клиентом и сервером. API задаёт доступные операции, формат данных и правила взаимодействия с системой. Эти понятия связаны, но не тождественны: API может использовать разные протоколы, а HTTP применяется не только для API. REST — один из подходов к построению интерфейса, а не название любого ответа в JSON.

Ключевые идеи

• Контракт должен объяснять входные данные, результат, ошибки и требования к доступу. Разработчику нужно понимать, что означает успешный ответ: приём запроса или фактическое завершение действия.
• Методы и коды HTTP помогают выразить смысл взаимодействия. Их последовательное применение облегчает работу клиентов, прокси и средств диагностики; собственные соглашения стоит описывать явно.
• Внешний сервис может отвечать медленно, временно отказывать или завершить операцию после разрыва соединения. Таймаут и повторная попытка требуют решения о допустимости повторного действия и защите от дублей.
• Аутентификация определяет участника взаимодействия, а авторизация — его права. Проверять доступ нужно для каждой существенной операции; секреты не следует помещать в публичный код и диагностические сообщения.
• Для сопровождения полезны идентификатор запроса, стабильный формат ошибки и примеры обмена. Изменение контракта требует согласования с потребителями, даже если серверный код удалось исправить одной строкой.

Вывод

Хороший API уменьшает количество догадок между разработчиками систем. PHP может реализовать серверную сторону, а JavaScript — использовать её в интерфейсе. Качество интеграции определяется ясным контрактом и поведением при сбоях не меньше, чем успешным демонстрационным запросом.

Источники

• MDN: обзор HTTP
• MDN: методы HTTP
• MDN: коды ответов HTTP