# 1.4 Версионирование в ФЕРЗЛ

#### <span style="font-family: PT Astra Serif, serif;">**1.4.1 Цели**</span>

<span style="font-family: PT Astra Serif, serif;">Версионирование API предназначено для обеспечения своевременного обновления решения у потребителей:</span>

- <span style="font-family: PT Astra Serif, serif;">Своевременное − поддерживается работа нескольких версий (поддерживается наличие не более трёх версий API) для обеспечения асинхронного обновления у потребителей, синхронное обновление желательно, но не обязательно.</span>
- <span style="font-family: PT Astra Serif, serif;">Решение − версионируется все решение целиком при изменении любого компонента в составе, версионирование отдельных сервисов и методов не ведется.</span>

#### <span style="font-family: PT Astra Serif, serif;">**1.4.2 Версии API**</span>

<span style="font-family: PT Astra Serif, serif;">Каждая версия отличается своим набором уникальных атрибутов:</span>

- <span style="font-family: PT Astra Serif, serif;">WSDL</span>
- <span style="font-family: PT Astra Serif, serif;">XSD</span>

<span style="font-family: PT Astra Serif, serif;">Общая формула формирования ссылок на версии:</span>

<span style="font-family: PT Astra Serif, serif;">%хост\_стенда%/api/<span lang="en-US">smo</span>/integration/ws/%номер\_версии%/%тип\_атрибута%/%название\_сервиса%</span>

<span style="font-family: PT Astra Serif, serif;">где внутри %% указаны значения, которые должны быть изменены для получения рабочих ссылок</span>

##### <span style="font-family: PT Astra Serif, serif;">Версия 24.2.3 СМО</span>

- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">WSDL</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiPolicyApplication.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiNR.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiPersonInfo.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiAsyncOperations.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiLegalRepresentation.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiStatusService.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">XSD</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiPolicyApplicationSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/commonTypesSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiNRSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiPersonInfoSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiAsyncOperationsSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiLegalRepresentationSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.3/mpiStatusServiceSchema.xsd</span></span>

##### <span style="font-family: PT Astra Serif, serif;">Версия 24.2.5 СМО</span>

- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">WSDL</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiPolicyApplication.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiNR.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiPersonInfo.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiAsyncOperations.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiLegalRepresentation.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiStatusService.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiPersonObjectsControl.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">XSD</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiPolicyApplicationSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/commonTypesSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiNRSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiPersonInfoSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiAsyncOperationsSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiLegalRepresentationSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiStatusServiceSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.5/mpiPersonObjectsControlSchema.xsd</span></span>

##### <span style="font-family: PT Astra Serif, serif;">Версия 24.2.<span lang="en-US">6</span> СМО</span>

- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">WSDL</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiPolicyApplication.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiNR.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiPersonInfo.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiAsyncOperations.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiLegalRepresentation.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiStatusService.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiPersonObjectsControl.wsdl</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">XSD</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiPolicyApplicationSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/commonTypesSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiNRSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiPersonInfoSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiAsyncOperationsSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiLegalRepresentationSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiStatusServiceSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">/api/smo/integration/24.2.6/mpiPersonObjectsControlSchema.xsd</span></span>

#### <span style="font-family: PT Astra Serif, serif;">**1.4.3 Версии элементов data (структура подписываемых документов)**</span>

<span style="font-family: PT Astra Serif, serif;">В версиях API, начиная с 24.1.4, структура &lt;element name="data" type="base64Binary"/&gt; версионируется по конкретным типам документов (в рамках вложения doc\_service\_xsd), отдельно от версионирования API.</span>

<span style="font-family: PT Astra Serif, serif;">Поддерживается наличие не более трёх версий одной схемы элементов data.</span>

##### <span style="font-family: PT Astra Serif, serif;">Версия<span lang="en-US"> doc\_service\_for\_smo\_adapter\_24.1.1</span></span>

- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">WSDL</span></span><span style="font-family: PT Astra Serif, serif;"> (</span><span style="font-family: PT Astra Serif, serif;">не</span><span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;">предполагается</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;"><span lang="en-US">XSD</span></span><span style="font-family: PT Astra Serif, serif;"> (с</span><span style="font-family: PT Astra Serif, serif;">хемы xsd, применяемые для валидации элементов data, содержащих массив байт с подписанным документом</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">commonTypes.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">mpiPolicyApplicationSchema.xsd</span></span>

##### <span style="font-family: PT Astra Serif, serif;">Версия<span lang="en-US"> doc\_service\_for\_smo\_adapter\_24.1.2</span></span>

- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">WSDL</span></span><span style="font-family: PT Astra Serif, serif;"> (</span><span style="font-family: PT Astra Serif, serif;">не</span><span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;">предполагается</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;"><span lang="en-US">XSD</span></span><span style="font-family: PT Astra Serif, serif;"> (с</span><span style="font-family: PT Astra Serif, serif;">хемы xsd, применяемые для валидации элементов data, содержащих массив байт с подписанным документом</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">commonTypes.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">mpiPolicyApplicationSchema.xsd</span></span>

##### <span style="font-family: PT Astra Serif, serif;">Версия<span lang="en-US"> doc\_service\_for\_smo\_adapter\_24.1.4</span></span>

- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">WSDL</span></span><span style="font-family: PT Astra Serif, serif;"> (</span><span style="font-family: PT Astra Serif, serif;">не</span><span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;">предполагается</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;"><span lang="en-US">XSD</span></span><span style="font-family: PT Astra Serif, serif;"> (с</span><span style="font-family: PT Astra Serif, serif;">хемы xsd, применяемые для валидации элементов data, содержащих массив байт с подписанным документом</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">commonTypes.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">mpiPolicyApplicationSchema.xsd</span></span>

##### <span style="font-family: PT Astra Serif, serif;">Версия<span lang="en-US"> doc\_service\_for\_smo\_adapter\_24.1.5</span></span>

- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">WSDL</span></span><span style="font-family: PT Astra Serif, serif;"> (</span><span style="font-family: PT Astra Serif, serif;">не</span><span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;">предполагается</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;"><span lang="en-US">XSD</span></span><span style="font-family: PT Astra Serif, serif;"> (с</span><span style="font-family: PT Astra Serif, serif;">хемы xsd, применяемые для валидации элементов data, содержащих массив байт с подписанным документом</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">commonTypes.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">mpiLegalRepresentationSchema.xsd</span></span>

##### <span style="font-family: PT Astra Serif, serif;">Версия<span lang="en-US"> doc\_service\_for\_smo\_adapter\_24.1.6</span></span>

- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">WSDL</span></span><span style="font-family: PT Astra Serif, serif;"> (</span><span style="font-family: PT Astra Serif, serif;">не</span><span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;">предполагается</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;"><span lang="en-US">XSD</span></span><span style="font-family: PT Astra Serif, serif;"> (с</span><span style="font-family: PT Astra Serif, serif;">хемы xsd, применяемые для валидации элементов data, содержащих массив байт с подписанным документом</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">commonTypes.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">mpiLegalRepresentationSchema.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">mpiStatusServiceSchema.xsd</span></span>

##### <span style="font-family: PT Astra Serif, serif;">Версия<span lang="en-US"> doc\_service\_for\_smo\_adapter\_24.2.5</span></span>

- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">WSDL</span></span><span style="font-family: PT Astra Serif, serif;"> (</span><span style="font-family: PT Astra Serif, serif;">не</span><span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;">предполагается</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"> </span><span style="font-family: PT Astra Serif, serif;"><span lang="en-US">XSD</span></span><span style="font-family: PT Astra Serif, serif;"> (с</span><span style="font-family: PT Astra Serif, serif;">хемы xsd, применяемые для валидации элементов data, содержащих массив байт с подписанным документом</span><span style="font-family: PT Astra Serif, serif;">)</span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">commonTypes.xsd</span></span>
- <span style="font-family: PT Astra Serif, serif;"><span lang="en-US">mpiPersonObjectsControlSchema.xsd</span></span>