SOAP
SOAP API передают информацию в виде XML-файлов и являются чрезвычайно распространенными протоколами веб коммуникаций. Аббревиатура SOAP расшифровывается как Simple Object Access Protocol, и она была разработана в конце 1990-х годов. Несмотря на свой возраст, SOAP по-прежнему остается одним из наиболее популярных типов API, используемых разработчиками.
Плюсы
Основным преимуществом SOAP является тот факт, что он полностью независим, когда дело доходит до языка программирования и платформы обработки. Стандартизированный формат гарантирует, что запрос может быть выполнен независимо от того, кто получает сообщение на другом конце.
Кроме того, в SOAP уже встроена обработка ошибок, что помогает разработчикам действовать на опережение и решать проблемы до того, как они разрастутся как снежный ком. Спецификация SOAP API позволяет возвращать XML-сообщение Retry с кодом ошибки и ее объяснением.
Возможно, самый сильный вариант использования SOAP связан с передачей данных с высоким уровнем безопасности. Здесь стандартизация SOAP творит чудеса, потому что она позволяет формально кодифицировать условия контракта и обеспечивать их соблюдение на протяжении всей работы API. Вы часто можете увидите это в таких чувствительных к данным отраслях, как финансовые услуги. Транзакции SOAP соответствует корпоративным стандартам, благодаря интеграции с протоколами WS-Security. SOAP гарантирует конфиденциальность и целостность внутри транзакций, обеспечивая при этом шифрование на уровне сообщений.
- Независимость от языка и платформы.
- Связанность с различными транспортными протоколами.
- Встроенная обработка ошибок.
- Ряд расширений безопасности.
Минусы
В качестве побочного эффекта, стандартизация SOAP делает формат запросов формат очень формальным и подробным. Каждое сообщение должно содержать:
- Тег <envelope> в начале и в конце.
- Текст, содержащий фактический запрос.
- Заголовок для конкретной информации и дополнительных требований.
- Любые ошибки, возникающие в процессе обработки.
SOAP в последние годы стал менее популярным из-за большого объема информации, которую он требует. XML-файлы большие и часто излишне громоздкие, особенно для простых систем. Количество людей, специализирующихся на SOAP-серверах, сокращается. Это затрудняет их обслуживание, если у вас еще нет нужных специалистов. Такое ощущение, что формат отстает от новых, более гибких методов коммуникации, которые предлагают более надежные и устойчивые результаты.
- Поддерживает только XML для запросов и ответов.
- Из-за большого размера XML файлов SOAP сервисы требуют большой пропускной способности.
- Требует глубокого понимания всех задействованных протоколов и их строгих правил.
- Требуются дополнительные усилия для добавления или удаления свойств сообщения, а жесткая схема SOAP замедляет этот процесс.
GraphQL
GraphQL был разработан в ответ на REST API. Основной идеей было то, что вы можете выполнить запрос, который извлекает только необходимые данные. Это в свою очередь уменьшает размер запросов и значительно упрощает процесс взаимодействия.
GraphQL - это изначально был внутренним протоколом Facebook. Он был впервые выпущен в 2015 году и быстро стал стандартным типом API. Вы начинаете с создания схемы, описывающей все возможные запросы и конкретные типы, которые они возвращают. Это может быть непросто, но после завершения API может принимать определенные запросы и возвращать результат, который в точности соответствует тому, что ищет пользователь.
В технологической индустрии продолжаются дебаты о том, должны ли компании создавать GraphQL API параллельно с существующим REST API или это должна быть полная замена.
Плюсы
Преимущества погружения в API GraphQL заключаются в том, что запросы API прозрачны и хорошо документированы. Они предоставляют пользователям всю необходимую информацию для эффективного их использования. Кроме того, точные результаты, подробные сообщения об ошибках и гибкие разрешения помогают создать хорошо сбалансированный и высокофункциональный API. Это особенно верно, когда дело доходит до структурирования данных, где GraphQL предоставляет пользователям значительную гибкость.
- Повышенная гибкость обеспечивает именно то, что требуется клиенту.
- Не имеет проблем чрезмерной и недостаточной выборки.
- Поддерживается популярными языками: JavaScript, Java, Python, Ruby и PHP.
- Позволяет настраивать структуру данных под клиента.
- Один запрос может содержать поля из нескольких ресурсов.
Минусы
Производительность GraphQL может снизиться, если у вас слишком много вложенных полей в каком-либо одном запросе. Он также не использует стандартную семантику HTTP-кэширования, поэтому требует специальных усилий для достижения надлежащего кэширования. Все это затрудняет освоение GraphQL.
- Запросы могут быть довольно сложными.
- Отсутствует встроенная поддержка кэширования.
- Более сложный процесс изучения по сравнению с REST.
- По умолчанию не поддерживается загрузка файлов.
В следующий раз мы рассмотрим несколько других популярных API.