API

🎓 API

Application Programming Interface ( API ) позволяет двум системам взаимодействовать друг с другом

Каждый API имеет документацию и спецификации, которые определяют способ передачи информации

API-интерфейсы могут использовать HTTP-запросы для получения информации от веб-приложения или веб-сервера

Предположим, существует некий внешний по отношению к вашему приложению набор сервисов

^{( т.е. который оказывает некие услуги вашему приложению )}

✅ Он может быть встроен в среду, в которой будет функционировать ваше приложение
( например, в браузере )

✅ или вы можете подключиться к нему удаленно ( например, firebase )

Для того, чтобы ваше приложение могло взаимодействовать с этим набором сервисов, нужен интерфейс

^{Так же, как нужны кнопки на фасаде кофе-машины, чтобы заставить эту машину делать то, что вам нужно}

---

Любой API работают по принципу «запрос» — «ответ»

^{нажали кнопку - машина включилась и сделала кофе
нажатие кнопки - запрос
кофе - ответ}

Ваше приложение посылает запрос, и если запрос валидный, то API присылает приложению ответ

Место, куда отправляется запрос, называется конечной точкой ( endpoint )

---

🎓 API endpoints

Взаимодействие с программным набором сервисов осуществляется через точки доступа к сервисам - endpoints

В частности, это точки доступа к сервисам API могут быть реализованы:

✅ как методы, которые можно вызвать в вашем коде ( Fetch API, File API )

✅ как условные идентификаторы ресурсов, к которым ваше приложение может получить доступ с помощью API ( REST API )

...

---

🎓 web service

📋 SOA — Service Oriented Architecture — сервис-ориентированная архитектура веб-приложений ( набор архитектурных принципов )

📋 RPC — Remote Procedure Call — удаленный вызов процедуры

📋 Сервис ( service ) — это набор операций, принимающих запрос ( Request ) и выдающих ответ ( Response )

📋 Веб-сервис — идентифицируемая веб-адресом программная система со стандартизированными интерфейсами

Веб-сервисы могут взаимодействовать друг с другом и со сторонними приложениями посредством сообщений, основанных на определённых протоколах

Наибольшее распространение получили следующие протоколы реализации веб-сервисов:

• SOAP ( Simple Object Access Protocol )
• REST ( Representational State Transfer )
• XML-RPC ( XML Remote Procedure Call )

Основной принцип REST заключается в ограничении набора операций — используются только операции CRUD ( Create Read Update Delete )

Архитектурный стиль REST в большинстве случаев подразумевает использование протокола HTTP

Поэтому команды CRUD преобразованы в HTTP-методы POST — GET — PUT — DELETE

---

🎓 SOAP vs REST

API обычно классифицируются как SOAP или REST, и оба используются для доступа к веб-сервисам

• SOAP: для обмена сообщениями используется формат XML
• REST: для получения или отправки информации используются URL-адреса

REST использует четыре разных HTTP 1.1 глагола ( GET, POST, PUT и DELETE )

В отличие от SOAP, REST не обязательно должен использовать XML для предоставления ответа

Существуют веб-сервисы на основе REST, которые выводят данные в формате:

    Command Separated Value ( CSV )
    JavaScript Object Notation ( JSON ) 
    Really Simple Syndication ( RSS )

Можно получить результат в формате, который легче парсить на языке вашего приложения