Общие принципы

Портал госпитализации имеет единый интерфейс загрузки данных. Для обращения к интерфейсу отправляется запрос вида:

#!php

/udata/data/uploadInterface/{$type}/{$sync}

Параметры:

• $type - тип загружаемых данных [branch, beds, direction и т.д.]
• $sync - режим загрузки данных [1 - синхронный, 0 - асинхронный]

Портал госпитализации поддерживает 2 режима загрузки данных - синхронный и асинхронный. Синхронный метод возвращает результат сразу после выполнения запроса на загрузку данных, асинхронный - после обработки данных сервером очередей.

Асинхронная загрузка

При асинхронной загрузке данных, в формат запроса для корневой ноды root добавляются дополнительные атрибуты:

• key - уникальный идентификатор файла
• ip - IP адрес сервера, на который надо отправить результат загрузки
• port - порт

Пример запроса для асинхронной загрузки

#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root key="3400" ip="127.0.0.1" port="30">
	...
</root>

Пример ответа при асинхронной загрузке

#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.098592">
    <response>
        <code>200</code>
        <data>
            <key>3400</key>
            <is_success>1</is_success>
            <id>...</id>
        </data>
    </response>
</udata>

Синхронная загрузка

При синхронной загрузке данных ответ возвращается сразу после обработки данных в ответ на запрос.

Пример запроса для синхронной загрузки

#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root>
	...
</root>

Пример ответа при синхронной загрузке

#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.098592">
    <response>
        <code>200</code>
        <data>
            <is_success>1</is_success>
            <id>...</id>
        </data>
    </response>
</udata>

Какой режим выбрать?

Общие рекомендации сводятся к следующим пунктам:

• Если загрузка данных критична и необходимо максимально быстрое получение ответа используйте синхронный режим.
• Если загрузка данных не критична по скорости получения ответа - используйте асинхронный режим.