> 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/id/guide/devices-and-settings/connectivity/data-forwarding/navixy-ws.md).

# Layanan Web Navixy

Izinkan sistem pihak ketiga membuat kueri data GPS historis dari Navixy melalui SOAP, dengan meminta hingga 100 perangkat dan data untuk satu hari per panggilan.

Navixy Web Service memberi sistem pihak ketiga sebuah endpoint SOAP yang digunakannya untuk meminta data pelacakan. Ini adalah opsi yang dipilih ketika sistem penerima lebih suka mengambil data sesuai jadwalnya sendiri, atau ketika sistem tersebut tidak dapat menerima koneksi masuk.

{% hint style="warning" %}
Navixy Web Service bekerja berbeda dari setiap protokol lain di dalam **Penerusan data** blok. Yang lainnya mendorong setiap pesan ke tujuan saat pesan tersebut tiba. Navixy Web Service tidak mendorong apa pun: Navixy menyediakan endpoint, dan sistem penerima meminta data yang diinginkannya.

Hal ini memiliki dua konsekuensi. Navixy tidak pernah terhubung ke sistem penerima, sehingga **Alamat** dan **Port** bidang-bidang tidak digunakan. Dan karena sistem penerima membaca data yang tersimpan, bukan aliran langsung, kueri dapat mencakup periode lampau, yang tidak didukung oleh protokol lain.
{% endhint %}

Karena datanya berupa XML melalui SOAP dan tidak melibatkan format khusus Navixy, protokol ini cocok untuk mitra mana pun yang dapat memproses WSDL.

Di Navixy, pilih **Navixy Web Service** di **Protocol** menu tarik-turun.

## Apa yang dikembalikan endpoint

Endpoint mengembalikan satu rekaman untuk setiap posisi yang tersimpan, dengan bidang-bidang berikut:

| Kolom                      | Isi                                                                                                                                                                      |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `deviceId`                 | ID perangkat sebagaimana diberikan dalam permintaan                                                                                                                      |
| `dateGps`                  | Waktu perangkat merekam posisi, dalam UTC                                                                                                                                |
| `latitude` dan `longitude` | Posisi dalam derajat                                                                                                                                                     |
| `ketinggian`               | Ketinggian dalam meter                                                                                                                                                   |
| `speedGps`                 | Kecepatan dalam kilometer per jam                                                                                                                                        |
| `haluan`                   | Arah sebagai arah mata angin, seperti `N`, `SE`, atau `O`                                                                                                                |
| `pengapian`                | Apakah pengapian menyala                                                                                                                                                 |
| `numSat`                   | Jumlah satelit yang digunakan perangkat                                                                                                                                  |
| `odometer`                 | Pembacaan odometer yang dilaporkan perangkat, dalam kilometer                                                                                                            |
| `unitPlate`                | Nomor registrasi kendaraan yang terhubung ke perangkat                                                                                                                   |
| `eventId`                  | Kode peristiwa, mengikuti [pengidentifikasi peristiwa Navixy Generic Protocol](/docs/iot-logic-api/technologies/navixy-generic-protocol/predefined-event-identifiers.md) |

Dua bidang bergantung pada data di luar perangkat. `unitPlate` Kosong saat perangkat tidak terhubung ke kendaraan, dan Navixy mempersingkat nomor registrasi dengan menghapus spasi dan tanda hubung serta mempertahankan enam karakter pertama. Perangkat yang tidak diizinkan untuk terhubung tidak mengembalikan rekaman sama sekali, melainkan kesalahan.

## Batas permintaan

Setiap permintaan harus tetap berada dalam batas-batas ini, atau endpoint mengembalikan fault:

* Paling banyak **100 ID perangkat** per permintaan.
* Paling banyak **satu hari** antara tanggal mulai dan tanggal akhir. Rentang yang sedikit lebih panjang masih ditoleransi, tetapi permintaan yang mencakup beberapa hari gagal dengan `Interval terlalu panjang`.

Untuk mengumpulkan periode yang lebih panjang, kirim satu permintaan per hari.

## Sebelum mulai

Berbeda dengan protokol lain, Anda tidak memerlukan apa pun dari pihak ketiga. Anda memilih login dan kata sandi, dan sistem penerima menggunakannya untuk autentikasi.

Pilih login yang belum digunakan oleh pengalih lain di akun Anda, karena Navixy mengidentifikasi pengalih berdasarkan pasangan login dan kata sandi.

## Siapkan endpoint

{% stepper %}
{% step %}

### Buka blok Penerusan data

Buka **Perangkat dan pengaturan**, pilih perangkat, lalu temukan **Penerusan data** blok.
{% endstep %}

{% step %}

### Buka daftar protokol

Klik **Protocols**, lalu klik **+** untuk menambahkan konfigurasi.
{% endstep %}

{% step %}

### Masukkan pengaturan Navixy Web Service

Isi kolom sebagai berikut:

* **Nama**: label yang mengidentifikasi retranslasi ini
* **Protocol**: **Navixy Web Service**
* **Alamat**: alamat apa pun yang valid. Protokol ini tidak menggunakannya, tetapi bidang ini wajib.
* **Port**: nomor port apa pun. Protokol ini juga tidak menggunakannya.
* **Login**: login pilihan Anda, yang belum digunakan oleh pengalih lain
* **Password**: kata sandi pilihan Anda

Berikan login dan kata sandi kepada pihak yang akan melakukan kueri ke endpoint.
{% endstep %}

{% step %}

### Aktifkan dan simpan

Nyalakan **Enabled**, lalu klik **Simpan**.
{% endstep %}

{% step %}

### Tautkan retranslator ke perangkat Anda

Di setiap perangkat **Penerusan data** perangkat, aktifkan sakelar untuk retranslasi yang Anda buat, lalu klik **Simpan**. Hanya perangkat yang ditautkan yang mengembalikan data. External ID tidak digunakan oleh protokol ini.
{% endstep %}
{% endstepper %}

## Lakukan kueri pada endpoint

Alamat WSDL bergantung pada platform yang menjadi host akun Anda:

| Platform | WSDL                                                  |
| -------- | ----------------------------------------------------- |
| EU       | <https://soap.navixy.com/LocationDataService?wsdl>    |
| US       | <https://soap.us.navixy.com/LocationDataService?wsdl> |

Kirim permintaan dalam formulir ini, dengan login dan kata sandi di header SOAP serta ID perangkat dan rentang tanggal di badan. ID perangkat adalah nilai IMEI dari perangkat:

{% 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 hingga 100 pengulangan:-->
         <deviceIds>866258048802349</deviceIds>
         <startDate>2022-08-30T00:00:00Z</startDate>
         <endDate>2022-08-31T00:00:00Z</endDate>
      </tem:dataRequest>
   </soapenv:Body>
</soapenv:Envelope>
```

{% endcode %}

Respons berisi satu `hasil` elemen per posisi tersimpan:

{% code overflow="wrap" %}

```xml
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
        <ns:getLocationDataResponse xmlns:ns="http://tempuri.org">
            <hasil>
                <dateGps>2019-10-15T08:48:50.000Z</dateGps>
                <pengapian>false</pengapian>
                <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>
```

{% endcode %}

## Kelola endpoint

Untuk mengubah atau mencabut akses:

* Matikan sakelar pada **Penerusan data** blok perangkat untuk mengecualikan perangkat tersebut dari hasil kueri, dan biarkan perangkat lain tetap tersedia.
* Klik **Protocols**, pilih barisnya, lalu edit untuk mengubah login atau kata sandi. Kueri yang menggunakan kredensial lama akan berhenti berfungsi segera, jadi beri tahu pihak yang melakukan kueri sebelum Anda mengubahnya.
* Hapus konfigurasi dari **Protocols** daftar untuk mencabut akses sepenuhnya. Konfirmasikan di dialog.

## Pemecahan masalah

Jika kueri tidak mengembalikan data, periksa hal berikut secara berurutan:

1. Retranslator diaktifkan, dan sakelarnya dinyalakan untuk perangkat yang Anda kueri.
2. Login dan kata sandi di header SOAP cocok dengan konfigurasi retranslator.
3. ID perangkat dalam permintaan adalah nilai IMEI dari perangkat di akun Anda.
4. Rentang tanggal mencakup periode saat perangkat tersebut mengirim data.
5. Rentang tanggal tidak lebih dari satu hari, dan permintaan mencantumkan tidak lebih dari 100 ID perangkat.

Untuk menguji permintaan sebelum menulis kode integrasi, gunakan [SoapUI](https://www.soapui.org/downloads/soapui/):

1. Instal SoapUI.
2. Dari **File** menu, pilih **New SOAP Project**.
3. Tempelkan alamat WSDL untuk platform Anda ke dalam **WSDL** bidang.
4. Pilih **Create sample requests for all operations**, lalu isi kredensial dan ID perangkat.


---

# 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/id/guide/devices-and-settings/connectivity/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.