> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/ru/guide/devices-and-settings/data-forwarding/navixy-ws.md).

# Navixy Web Service

{% hint style="info" %}
**Категория протокола:** Протокол консолидации данных
{% endhint %}

#### Содержание

1. [Что такое Navixy Web Service?](#what-is-ws)
2. [Техническая информация о Navixy Web Service](#tech-info-ws)
3. [Настройка Navixy Web Service](#ws-config)
4. [Настройка](#setting-up)
5. [Управление](#managing)
6. [Устранение неполадок](#troubleshooting)

### Что такое Navixy Web Service?

**Navixy Web Service** протокол пересылки данных передаёт данные автопарка из системы Navixy в любую стороннюю систему. Протокол гибкий и позволяет сторонним организациям хранить данные автопарка в своих базах данных для использования в любых целях или отображать данные на веб-ресурсах.

Поскольку этот протокол пересылки данных не зависит от платформы, он станет идеальным вариантом для любого партнёра, работающего с XML-файлами.

### Общая техническая информация о Navixy Web Service

Протокол Navixy Web Service использует SOAP для получения XML-данных с устройств слежения в рамках прикладного уровня OSI. Данные запрашиваются по мере необходимости.

Передаваемые поля данных:

* `dateGPS`: Дата и время в UTC
* `ignition`: Булево состояние зажигания
* `широта`
* `долгота`
* `speedGPS`: км/ч
* `unitPlate`: Номерной знак
* `altitude`: Метры
* `course`: Направление движения транспортного средства, например: **N,S,E,O,NO,NE,SO,SE**
* `deviceId`: IMEI
* `numSat`: Количество спутников GNSS, которые использует устройство
* `odometer`: Пройденное расстояние в км
* `eventId`: код события согласно [Navixy Generic Protocol event ID](https://www.navixy.com/docs/iot-logic-api/technologies/navixy-generic-protocol/navixy-generic-protocol-10/predefined-event-identifiers)

### Настройка Navixy Web Service

#### Настройка

Чтобы настроить пересылку данных в протоколе Navixy Web Service:

1. Перейдите в **Устройства и настройки** на левой боковой панели.
2. Выберите нужное устройство из **Объекты** списке.
3. Найдите **Перенаправление данных** блок, разверните его и нажмите <img src="/files/c1b9db26d215bd68d464544bff2c854baa7115ce" alt="" data-size="line">.
4. В открывшемся окне нажмите «+», чтобы добавить новую ретрансляцию.
5. В поле **Новый протокол ретрансляции** диалоге введите необходимую информацию. Для протокола Navixy Web Service заполните следующие поля:

<table><thead><tr><th width="187.8182373046875">Параметр</th><th>Пояснение</th></tr></thead><tbody><tr><td>Имя</td><td>Описательная метка для идентификации этой конфигурации протокола ретрансляции. Введите имя, чтобы этот ретранслятор было легко идентифицировать.</td></tr><tr><td>Протокол и логин</td><td>Протокол связи, используемый для ретрансляции. Выберите <strong>Navixy Web Service</strong> в раскрывающемся меню.</td></tr><tr><td>Адрес</td><td>URL или IP-адрес целевого сервера.<br><strong>Примечание</strong>: Он не используется Navixy Web Service, введите любой допустимый формат адреса.</td></tr><tr><td><strong>Порт</strong></td><td>Сетевой порт для подключения к целевому серверу.<br><strong>Примечание</strong>: Он не используется Navixy Web Service, введите любой номер порта.</td></tr><tr><td>Логин</td><td>Уникальный идентификатор для этого подключения ретранслятора. Введите любой логин, который ещё не используется другим ретранслятором в вашей системе.</td></tr><tr><td>Пароль</td><td>Код аутентификации для этого подключения ретранслятора. Введите уникальный пароль для защиты этой конфигурации ретранслятора.</td></tr></tbody></table>

6. Переключите **кнопка «Включено»** тумблер в положение включено, чтобы активировать ретрансляцию данных. Ретранслятор не будет передавать данные, пока он отключён.
7. Отчёт **Управление ретрансляцией** экран должен выглядеть примерно так, с логином и паролем Navixy Web Service. Убедитесь, что статус **Активен** если вы хотите, чтобы этот ретранслятор отправлял данные.\
   ![](/files/55d0ffbdbdaa3e112b291a4af26ef008455cd890)
8. Далее ретранслятор нужно привязать к устройству. Для этого включите переключатель с нужным названием ретранслятора в **Перенаправление данных** блоке. Внешний ID для протокола Navixy Web Service не требуется.\
   ![](/files/862885f1ca4c45cbf94294b317eba96b54fb6691)

{% hint style="success" %}
Вы успешно создали и включили новый протокол ретрансляции для этого устройства. Теперь ретранслятор доступен для всех устройств в аккаунте; вы можете включить его, переключив тумблер в настройках других устройств.
{% endhint %}

#### Внешний доступ:

Обязательные параметры:

* **Логин и пароль**: Они должны соответствовать учётным данным, которые вы задали в конфигурации ретранслятора
* **deviceIDs**: Макс. 100
* **startDate** и **endDate**: Например, 9 сентября 2022 г., с 00:00 UTC до 11:59:59
  * UTC: 2022-09-01T00:00:00Z to 2022-09-01T11:59:59Z

Описание протокола в WSDL можно найти ниже, в зависимости от того, где расположен сервер:

EU <https://soap.navixy.com/LocationDataService?wsdl>

US <https://soap.us.navixy.com/LocationDataService?wsdl>

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

{% code overflow="wrap" %}

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org">

   <soapenv:Header>
   <tem:authentication>
     <login>username</login>
     <password>password</password>
   </tem:authentication>
   </soapenv:Header>
   <soapenv:Body>
   <tem:dataRequest>
      <!--1 to 100 repetitions:-->
      <deviceIds>IMEI of device</deviceIds>
      <startDate>2022-08-30T00:00:00Z</startDate>
      <endDate>2022-08-31T00:00:00Z</endDate>
   </tem:dataRequest>
   </soapenv:Body>
</soapenv:Envelope>
```

{% endcode %}

Пример ответа может выглядеть так:

```xml
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
        <ns:getLocationDataResponse xmlns:ns="http://tempuri.org">
            <result>
                <dateGps>2019-10-15T08:48:50.000Z</dateGps>
                <ignition>false</ignition>
                <latitude>75.9270866</latitude>
                <longitude>-85.5207616</longitude>
                <speedGps>0.0</speedGps>
                <unitPlate>JRT1550</unitPlate>
                <altitude>284.0</altitude>
                <course>N</course>
                <deviceId>866258048802349</deviceId>
                <numSat>15</numSat>
                <odometer>59845</odometer>
                <eventId>401</eventId>
            </result>
        </ns:getLocationDataResponse>
    </S:Body>
</S:Envelope>
```

#### Управление

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

1. В любом **Перенаправление данных** блоке нажмите <img src="/files/28af1e082105ef7431745f7f092746f6ac2d3f5c" alt="" data-size="line"> чтобы открыть список доступных протоколов.
2. Нажмите <img src="/files/c96f2e92ddc442c546e1a81d48759cfc8de9f035" alt="" data-size="line"> чтобы изменить настройки ретранслятора, такие как имя, данные для входа или статус включения.
3. Нажмите <img src="/files/11e0323f0e1c48933930de9e9ea03e688930085b" alt="" data-size="line"> и подтвердите удаление ретранслятора

Все изменения сохраняются автоматически.

{% hint style="info" %}
Чтобы включить или отключить ретранслятор для определённого устройства, переключите тумблер с нужным названием ретранслятора в **Перенаправление данных** блок.
{% endhint %}

#### Устранение неполадок

Чтобы проверить и протестировать SOAP-запрос к платформе, рекомендуется использовать SoapUI, который можно найти здесь: <https://www.soapui.org/downloads/soapui/>

1. Установите Soap UI
2. В меню файла выберите «New SOAP Project»
3. Вставьте правильный путь в поле WSDL в соответствии с сервером и выберите **Create sample requests for all operations?**
4. US: <https://soap.us.navixy.com/LocationDataService?wsdl>
5. EU: <https://soap.navixy.com/LocationDataService?wsdl>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/user/ru/guide/devices-and-settings/data-forwarding/navixy-ws.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.