Введение в Rest API
Сегодня IТ-технологии развиваются невероятно быстро, открывая для пользователей все больше высокотехнологичных решений, упрощающих работу и жизнь в целом. Так, одной из последних новинок рынка в сфере получения, извлечения, размещения и удаления данных стал прикладной программный интерфейс REST API. Он работает на основании HTTP-протокола, используя его запросы. Познакомимся с технологией Rest API более подробно. С тем, что она собой представляет, базовыми понятиями, основными принципами, особенностями и сферой применения.
Что представляет собой Rest API: базовые понятия
Чтобы разобраться в особенностях нового программного интерфейса необходимо четко понимать, что такое API (Application Programming Interface). Так, это код, согласно которому интернет-сайт обеспечит совместное взаимодействие двух программ. API дает разработчикам подсказки правильного написания приложений, которые будут запрашивать информацию или у операционной системы, или у другой программы.
API предусматривает тот факт, что приложения могут выполнять действия даже на разных компьютерах. В этом случае функции будут запрашиваться через сеть. А еще он учитывает тот факт, что приложения могут быть написаны на разных языках. То есть это некий стандарт, позволяющий отдельным софтам «понимать» друг друга, универсальный язык интернета. И с ним работает большая часть современных сайтов и программ. При этом используется протокол передачи данных HTTP или HTTPS (версия HTTP, но с функцией шифрования данных).
Состояния представления, подход к коммуникациям, архитектурный образ Rest API очень схожи с теми, что применяются при создании облачных служб. Аналогом этого программного интерфейса можно назвать технологию SOAP. Но она имеет один существенный недостаток – низкую пропускную способность, что негативно сказывается на скорости обработки: отвечает долго. И это снижает эффективность ее использования.
Разобраться в особенностях Rest API помогут примеры запросов. Так, есть сайт: https://site.ru/catalog/category. Первая часть, https://site.ru – это адрес самого сайта. А вот каждая последующая часть, разделенная слешем – это уже адрес каталогов, подкаталогов на удаленном сервере. То есть, вводя этот адрес, мы изначально попадаем на сервер site.ru, а уже с него запрашиваем каталог /catalog подкаталог /category. То есть мы точно указываем, куда надо направить запрос, чтобы получить необходимую информацию.
Основные принципы
Основные принципы того, как работает Rest API изложены создателем этого программного интерфейса, Роем Филдингом. Так, из основных моментов стоит выделить:
- наличие единого стандартизированного интерфейса;
- отсутствие сохранения состояния;
- четкое разделение клиента и сервера;
- в любой момент времени может использоваться кеширование;
- наличие многоуровневой системы;
- чтобы получить код, необходимо изначально отправить запрос.
Рассмотрим эти моменты подробнее.
Наличие единого стандартизированного интерфейса
Все ресурсы, которые будут работать с данным программным интерфейсом должны быть идентифицированы при помощи одного URL-адреса. При этом могут использоваться любые базовые методики сетевого протокола: HTTP, PUT, DELETE, GET.
Отсутствие сохранения состояния
Все операции, которые проходят между клиентом и сервером будут выполняться без сохранения состояния. То есть, функция управления состояния должна быть передана клиенту, на нем и выполняться. Сервер к этому процессу не будет иметь никакого отношения.
Четкое разделение клиента и сервера
Обязанности между клиентом и сервисом должны быть четко распределены. Так, на клиента перебрасывается задача сбора запросов и обеспечение пользовательского интерфейса. В обязанности сервера входит предоставление доступа к информации и управление безопасностью, управлением рабочей нагрузкой.
Использоваться кеширования
Кеширование – обязательная операция. И все ресурсы должны разрешать проводить ее. Исключение – сервисы, в которых изначально указано, что кеширование невозможно реализовать.
Наличие многоуровневой системы
В REST API можно реализовать даже сложную архитектуру, состоящую из нескольких уровней серверного обеспечения.
Запрос на код
На практике наиболее часто сервер направляет клиенту статические представления ресурсов в одном из форматов: JSON или XML. Но, если потребуется, сервер сможет отправить сообщение с исполняемым кодом напрямую клиенту.
Стандарты REST API
До того как на IТ-рынке появилось Rest API приложение, разработчики применяли популярный программный интерфейс SOAP. И здесь им приходилось вручную прописывать документы XML с удаленным вызовом процедур непосредственно в теле. Такие сложности и сподвигли группу калифорнийских разработчиков во главе с Роем Филдингом создать совершенно новый стандарт, в котором один сервер мог бы беспрепятственно обмениваться информацией с другими серверами, вне зависимости от того, какого типа он идет. Он определил как сам REST, так и ограничения, которые относились к API. За основу разработчики взяли API-интерфейсы RESTful, что позволило им расширить функциональные возможности сайтов и приложений.
Проверка оригинальности REST API зависит от того, в каком контексте будет использоваться программный интерфейс. Так, если надо будет проложить путь по API-карте, то можно использовать сторонне приложение. При этом оно будет считаться зарегистрированным пользователем, получит набор прав и разрешений. Но вот в другом случае максимум, что оно сможет, так это получить доступ к определенным данным, как пример, электронной почте.
Но, наряду с преимуществами, Rest API имеет и свои недостатки. Так, наиболее существенный из них – низкая стойкость к взлому. Предусмотрено список правил, соблюдая которые можно повысить стойкость ресурсов к несанкционированному доступу:
- использовать не открытый протокол HTTP, а с шифрованием – HTTPS;
- использовать только надежные сервисы проверки оригинальности;
- для ограничения вызовов на стороне клиента Rest API определенными доменами, следует воспользоваться CORS;
- исключить неиспользуемые опции DELETE, то есть обеспечить минимальные функциональные возможности;
- проверять адреса конечной точки и данные тела;
- предусмотреть блокировку доступа с неизвестных IP-адресов, доменов;
- в клиентском JavaScript не выставлять токены API;
- даже если нагрузка полезная, но очень большого объема, ее лучше блокировать;
- постоянно следить за сбоями, регистрировать новые запросы;
- ориентироваться на код состояния HTTP и кэширование заголовка при настройке ответов;
- скорость работы тех запросов, которые используют одинаковый REST API или IP-адрес должна быть ограничена.
Особенности работы REST API
В работе REST API разбивает весь transfer на серию небольших по объему модулей. Каждый из них будет обращаться к определенной части транзакции. На практике такой способ открывает перед разработчиками достаточно широкие возможности. Но только в том случае, когда речь идет о собственном REST API, созданном с нуля. Если же требуемых навыков пока нет, можно воспользоваться и стандартными базовыми моделями, CDMI или OpenStack Swift.
В работе REST API использует 4 классические подсистемы:
- GET. Метод чтения информации, который применяется для возвращения информации с сервера. Они не меняют ее, не удаляют.
- POST. Предназначается для создания новых записей, новых ресурсов.
- PUT. Позволяет вносить изменения в имеющиеся записи, их редактирование. Выполняется в форме файла, блока.
- DELETE. Удаляет как весь ресурс, так и определенные записи.
То есть одна программа может использовать все эти функции при работе с ресурсами. То есть передача состояния представления (REST API) – это и есть построение API-системы на основе ресурсов, протоколов HTTP и запросов, ведущих к ним.
Где REST API будет незаменим?
REST API широко применяется в процессе организации взаимодействия между отдельными приложениями. Это стало возможным благодаря тому, что протокол HTTP актуален для всех операционных систем и языков программирования.
Наиболее широкое использование Rest API получило в системах:
- связи серверов и мобильных приложений;
- построения микросерверных софтов: одно большое приложение разбивается на более мелкие составные элементы;
- обеспечения доступа к программным продуктам сторонних разработчиков и пр.
Более подробно с особенностями и сферой применения данного программного интерфейса вас познакомят специалисты компании «Xelent». Консультации и профессиональную помощь можно получить по телефону или через онлайн-сервисы связи.
