Что такое WSDL

Что проверяют

Работали ли вы с SOAP-интеграциями и умеете ли читать формальный контракт, а не только словесное описание обмена. Для аналитика WSDL это готовая половина технического задания на интеграцию: из него видно состав операций, обязательность полей, типы и адрес сервиса.

Как отвечать

WSDL (Web Services Description Language) это XML-описание веб-сервиса, машиночитаемый контракт. По нему клиент понимает, какие операции доступны, что отправлять и куда. Из WSDL генерируются классы клиента и заготовка сервера, поэтому расхождение кода с контрактом это дефект, а не вариант реализации.

Разделы, которые стоит назвать:

• types: типы данных, обычно через XML Schema. Здесь живут обязательность полей, длины, перечисления и вложенность.
• message: из каких частей состоит запрос и ответ.
• portType (в поздней редакции стандарта interface): перечень операций.
• binding: как операции ложатся на протокол, чаще всего SOAP поверх HTTP.
• service и port: конечные точки, то есть адреса, по которым сервис доступен.

Дальше свяжите это со своей работой: по WSDL пишется спецификация интеграции и матрица соответствия полей, тестовый запрос собирается в SoapUI или Postman за минуту, а совместимость версий обсуждается заранее. Добавление необязательного поля обычно безопасно, смена типа или обязательности ломает всех клиентов, поэтому несовместимую версию выносят в отдельное пространство имён и отдельный адрес.

Где спотыкаются

Путают WSDL и SOAP. SOAP это формат конверта сообщения, а WSDL описывает сервис целиком и может ссылаться не только на SOAP-привязку.

Считают WSDL делом разработчиков. Именно аналитик согласует по нему состав полей, справочники значений и коды ошибок, и именно он замечает, что в схеме обязательным стало поле, которого нет у смежной системы.

Думают, что контракт полон. WSDL молчит про бизнес-правила, идемпотентность повторной отправки, лимиты, таймауты и смысл кодов в SOAP Fault: это описывается рядом, обычным текстом.