Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 <h2>SOAP API</h2>

2 SOAP API- это способ, с помощью которого программы обмениваются сообщениями по сети. Расшифровка -Simple Object Access Protocol("простой протокол доступа к объектам"). Если объяснить простыми словами, SOAP - этоправила для обмена структурированными XML-сообщениямимежду приложениями через интернет или корпоративные сети.

3 SOAP появился еще в конце 1990-х годов и стал основой множества корпоративных интеграций. Несмотря на рост популярности REST и GraphQL,simple object access protocolдо сих пор активно используется там, где важныстрогие контракты, безопасность, надёжность- в банках, телекомах, госуслугах, крупных корпоративных системах.

4 <h2>Где используется сегодня</h2>

5 SOAP-веб-сервисы чаще всего встречаются:

6 <ul><li>вбанковских API(платёжные шлюзы, валютные курсы, отчётность);

7 </li>

8 <li>утелеком-операторов(биллинговые системы, роуминг, CRM);

9 </li>

10 <li>вгосударственных сервисах(Госуслуги, ЕГАИС, СМЭВ);

11 </li>

12 <li>вERP, интеграционных шинах(SAP, Oracle, 1С, BizTalk).

13 </li>

14 </ul>Сервисы удобны там, где нужно не просто "передать данные", а строго следоватьописанному контракту (WSDL)и обеспечивать надежность, безопасность сообщений.

15 <h2>Архитектура SOAP и стек WS-*</h2>

16 SOAP - это не просто XML, а часть большогоWS-стека (Web Services). Основные компоненты:

17 <ul><li>SOAP- формат сообщений, правил обмена;

18 </li>

19 <li>WSDL- контракт, описывающий, какие методы / данные поддерживает сервис;

20 </li>

21 <li>WS-Addressing- задаёт маршрутизацию сообщений;

22 </li>

23 <li>WS-Security- обеспечивает подписи, шифрование, аутентификацию;

24 </li>

25 <li>WS-ReliableMessaging- отвечает за гарантированную доставку;

26 </li>

27 <li>WS-AtomicTransaction- координирует распределенные транзакции.

28 </li>

29 </ul>Таким образом, SOAP - это фундамент, на котором строится целый стек надежных веб-сервисов.

30 <h2>Из чего состоит сообщение SOAP</h2>

31 SOAP-сообщение всегда представляет собой XML-документ со структурой:

32 Основные элементы:

33 <ul><li>Envelope- оболочка всего сообщения.

34 </li>

35 <li>Header- метаданные (авторизация, маршрутизация, подписи).

36 </li>

37 <li>Body- основное содержимое (запрос или ответ).

38 </li>

39 <li>Fault- описание ошибки.

40 </li>

41 </ul><h3>SOAP 1.1 vs SOAP 1.2</h3>

42 <ul><li>В SOAP 1.2 используется атрибут soap:role вместо actor.

43 </li>

44 <li>mustUnderstand - булев (true/false), а не числовой (1/0).

45 </li>

46 <li>Кодировки, пространства имён отличаются, поэтому версии несовместимы.

47 </li>

48 <li>SOAP 1.2 - сам по себене гарантирует надёжность; она обеспечиваетсяWS-ReliableMessaging.

49 </li>

50 </ul><h2>Примеры XML для запроса и ответа</h2>

51 Пример запроса:

52 Пример ответа:

53 Ошибка (Fault):

54 <h2>Формат данных и вложения</h2>

55 Основной формат данных в SOAP -XML, но возможны вложения:

56 <ul><li>MTOM/XOP- передача бинарных файлов (например, PDF, изображений) в виде вложений, а не base64 внутри XML.

57 </li>

58 <li>base64Binary- альтернатива, если MTOM не поддерживается.

59 </li>

60 </ul>Это делает SOAP гибким для сложных интеграций, где нужны документы, медиафайлы.

61 <h2>Транспорт и HTTP SOAP</h2>

62 Чаще всего SOAP работает поверхHTTP/HTTPS.

63 Типичные заголовки:

64 SOAP 1.1

65 POST /service HTTP/1.1 Content-Type: text/xml; charset=utf-8 SOAPAction: "GetBalance"

66 SOAP 1.2

67 POST /service HTTP/1.1 Content-Type: application/soap+xml; charset=utf-8; action="GetBalance"

68 При ошибках сервис может вернутьHTTP 500(Fault) или200(успешный ответ).

69 Кроме HTTP, возможны альтернативные транспорты -SMTP, JMS, MQ,другие.

70 <h2>Стили и кодирование</h2>

71 SOAP поддерживает два стиля:

72 <ul><li>RPC (Remote Procedure Call)- имитирует вызов функции.

73 </li>

74 <li>Document- передаёт документы с данными (рекомендуется).

75 </li>

76 </ul>По способу кодирования:

77 <ul><li>encoded- старый формат (SOAP encoding);

78 </li>

79 <li>literal- предпочтительный, совместимый с WS-I Basic Profile.

80 </li>

81 </ul><h2>Контракт: WSDL "для чайников"</h2>

82 ФайлWSDL (Web Services Description Language)- это XML-контракт, описывающий:

83 <ul><li>types- используемые структуры данных (XSD);

84 </li>

85 <li>message- входные / выходные сообщения;

86 </li>

87 <li>portType- операции (методы);

88 </li>

89 <li>binding- способ передачи (SOAP 1.1/1.2);

90 </li>

91 <li>service- адреса (endpoint’ы).

92 </li>

93 </ul>Клиент по WSDL может автоматически сгенерировать код:

94 <ul><li>Java: wsimport;

95 </li>

96 <li>.NET: svcutil;

97 </li>

98 <li>Python: zeep.

99 </li>

100 </ul><h2>Синхронный или асинхронный</h2>

101 SOAP-вызовы могут быть:

102 <ul><li>синхронными(request/response);

103 </li>

104 <li>асинхронными- с колбэками или polling (опросом).

105 </li>

106 </ul>Для связывания запросов / ответов используютcorrelation IDs.

107 <h2>Обработка ошибок</h2>

108 В SOAP 1.1 ошибка описывается через <soap:Fault>, а в 1.2 - структура изменена:

109 Ошибки обычно маппятся наHTTP 500(внутренняя ошибка) или400(некорректный запрос).

110 <h2>Безопасность и надежность</h2>

111 SOAP сам по себе не шифрует, не подписывает данные - это делают расширения:

112 <ul><li>WS-Security- подпись, шифрование, токены:

113 <ul><li>UsernameToken, X.509, SAML;</li>

114 </ul></li>

115 <li>WS-ReliableMessaging- гарантирует доставку, порядок сообщений;

116 </li>

117 <li>WS-Policy- описывает требования к безопасности;

118 </li>

119 <li>TLS/HTTPS- защищает транспорт.

120 </li>

121 </ul><h2>Практика и инструменты</h2>

122 Тестирование:

123 <ul><li>SoapUI- популярный инструмент для создания / отладки запросов;

124 </li>

125 <li>Postman- тоже поддерживает SOAP (через XML-тело);

126 </li>

127 <li>cURL- можно отправить вручную:

128 </li>

129 </ul>curl -X POST -H "Content-Type: text/xml" -d @request.xml https://example.org/service

130 Генерация клиента:

131 <ul><li>Java: wsimport;

132 </li>

133 <li>.NET: svcutil;

134 </li>

135 <li>Python: zeep.

136 </li>

137 </ul><h2>Сравнение SOAP и REST</h2>

138 Выбирают SOAP, если важны безопасность, транзакции, строгие контракты.

139 REST- когда нужна простота, скорость.

140 <h2>Частые проблемы и отладка</h2>

141 <ul><li>Ошибки вnamespace (xmlns)- частая причина "Invalid SOAP message".

142 </li>

143 <li>Несовпадение типов XSD при сериализации.

144 </li>

145 <li>Большие вложения → включают MTOM.

146 </li>

147 <li>Проблемы с таймаутами, SSL-сертификатами.

148 </li>

149 </ul><h2>FAQ по ключам</h2>

150 <ul><li>SOAP-запрос - этоXML-сообщение, отправляемое клиентом на сервер.

151 </li>

152 <li>Envelope SOAP- внешняя оболочка сообщения.

153 </li>

154 <li>SOAP-метод- операция, определенная в WSDL.

155 </li>

156 <li>Формат данных- XML, с поддержкой MTOM/XOP для бинарных вложений.

157 </li>

158 <li>HTTP SOAP- наиболее распространенный транспортный протокол.

159 </li>

160 </ul><h2>Глоссарий</h2>

161 <ul><li>Envelope- контейнер SOAP-сообщения.

162 </li>

163 <li>Header- метаданные, служебная информация.

164 </li>

165 <li>Body- данные запроса или ответа.

166 </li>

167 <li>Fault- структура ошибки.

168 </li>

169 <li>WSDL- описание контракта веб-сервиса.

170 </li>

171 <li>binding- способ передачи данных.

172 </li>

173 <li>portType- набор операций сервиса.

174 </li>

175 <li>MTOM/XOP- механизмы передачи бинарных вложений.

176 </li>

177 </ul><h2>Полезные материалы и спецификации</h2>

178 <ul><li><a>SOAP 1.1 Specification (W3C)</a>

179 </li>

180 <li><a>SOAP 1.2 Part 1: Messaging Framework</a>

181 </li>

182 <li><a>WSDL 1.1/2.0 Specifications</a>

183 </li>

184 <li>WS-Security Specification

185 </li>

186 <li>WS-ReliableMessaging

187 </li>

188 <li>Обзор SOAP на Habr

189 </li>

190 </ul>