Restful API
API
API — это соединители одного приложения с другим. Они делают каждое приложение сильнее, позволяя каждому использовать инструменты и ресурсы других приложений. Они превращают мир программирования в нечто вроде живого дышащего организма, состоящего из бесконечного числа рабочих частей, движущихся вместе к одной цели, делающей жизнь более эффективной, увлекательной и легкой. По сути, API-интерфейсы являются переводчиками между нашими приложениями, позволяя им обмениваться информацией и помогать друг другу выполнять свою работу.
ОТДЫХ
REST можно описать как набор правил, которым должны следовать API. Мы следуем рекомендациям REST, чтобы сделать наши API универсальными. Итак, давайте обсудим некоторые из этих рекомендаций
Терминология
Ресурс — объект/представление данных, с которым связаны некоторые данные, и может быть набор методов для работы с ним. пример: Домашние животные, Классы и Пользователи — это ресурсы, а удаление, добавление, обновление — операции, которые должны выполняться над этими ресурсами.
Коллекции — это набор ресурсов, например: URL-адреса — это набор URL-ресурсов.
URL (унифицированный локатор ресурсов) — это путь, по которому можно найти ресурс и выполнить над ним некоторые действия.
Коды состояния
Еще одним стандартом для REST являются коды состояния и их значения. Из-за этого ошибки общеизвестны, и каждая из них имеет значение. Ниже я собираюсь в общих чертах объяснить, что означает каждый раздел каждого кода ошибки.
Коды состояния 2XX — эти коды состояния означают, что запрошенное действие было получено и успешно обработано сервером.
Коды статуса 3XX — код ответа статуса перенаправления указывает, что на запрос есть несколько возможных ответов.
Коды состояния 4XX.Эти коды состояния означают, что клиент отправил ошибочный запрос.
Коды состояния 5XX — код ответа сервера об ошибке указывает на то, что сервер столкнулся с непредвиденной ситуацией, которая помешала ему выполнить запрос.
Последний стандарт, о котором мы поговорим, — это методы, которые мы используем, включая GET, POST, PUT, PATCH и DELETE.
GET — метод запрашивает данные у ресурса и не должен давать побочного эффекта.
POST — метод запрашивает у сервера создание ресурса в базе данных, в основном при отправке веб-формы.
PUT — метод запрашивает у сервера обновить ресурс или создать ресурс, если он не существует.
PATCH — идемпотентный, что означает, что несколько запросов будут иметь одинаковый эффект.
DELETE — метод запрашивает удаление ресурса или его экземпляра из базы данных.
В заключение
Restful API позволяет экосистеме разработки программного обеспечения расти быстрее, чем без нее. Возможность подобрать чужой REST API и беспрепятственно начать его использовать бесценна. Это также упрощает понимание отношений клиент-сервер для новичков, потому что существует стандарт, который по большей части принимается большинством разработчиков. REST никуда не денется, и это очень важная часть будущего разработки программного обеспечения.
