WSDL

XML "Swagger"

WSDL (Web Services Description Language) — это язык описания веб-сервисов, основанный на XML. На нем описываются методы, входные и результирующие структуры данных, типы данных, сетевые адреса для обращения к сервису и другое.

SOAP связан с WSDL по той части, что SOAP обеспечивает транспорт, а WSDL обеспечивает объявление веб-сервиса.

Элементы WSDL

Существуют две версии языка:

• версия 1.1 от 2001 года, https://www.w3.org/TR/wsdl.html

• версия 2.0 от 2007 года, https://www.w3.org/TR/wsdl/

Документы WSDL состоят из следующих разделов:

Раздел	Версия 1.1	Версия 2.0
<definitions>	Задает пространства имен для документа WSDL, XML-схемы и SOAP	Отсутствует. Вместо него существует раздел <description>
<description>	Отсутствует. Вместо него существует раздел <definitions>	Задает пространства имен для документов WSDL, XML и SOAP
<types>	Элементы (данные), с которыми работает веб-сервис	Аналогично
<message>	Сообщения, с которыми работает веб-сервис	Отсутствует
<portType>	Операции, которые могут проводиться с сообщениями из раздела <message>	Отсутствует. Вместо него существует раздел <interface>
<interface>	Отсутствует. См. раздел <portType>	Операции, которые могут проводиться с элементами (данными) из раздела <types>
<binding>	Определение сетевого протокола и формат данных, используемых для операций из раздела <portType>	Аналогично
<operation>	Абстрактное определение операции (функции), в которой указываются входящее и исходящее сообщения, а так же сообщение об ошибке.	Аналогично
<service>	Объединяет конечные точки (адреса), реализующие общий интерфейс веб-сервиса. В разделе указывается общий адрес веб-сервиса	Аналогично
<port>	Протоколы и адреса, по которым выполняются запросы к веб-сервису	Отсутствует
<endpoint>	Отсутствует. Вместо него существует раздел <port>	Протоколы и адреса, по которым выполняются запросы к веб-сервису

Источники:

• https://yandex.ru/dev/direct/doc/dg-v4/concepts/SOAP.html
• https://vbeg.ru/tezam/soap-i-wsdl-teoriya/
• https://systems.education/soap-integration (подробнее)