---
title: Postupak preuzimanja podataka
weight: 1
section: 'Guides'
---

import Alert from '@/components/docs/Alert.astro';
import Steps from '@/components/docs/Steps.astro';

<Steps>
### Početna autentifikacija

<Alert type="warning">
  Pri preuzimanju podataka važno je ispravno pripremiti zahtjev s pravilno zadanim ulaznim
  parametrima. Zaglavlje zahtjeva mora sadržavati `header "Content-Type: application/json"` (primjer
  poziva detaljno je opisan u pododjeljku [„Autentifikacija”](/hr/api/v1#autentifikacija)).
</Alert>

Početna autentifikacija opisana je u pododjeljku [Autentifikacija](/hr/api/v1#autentifikacija).

Za početnu autentifikaciju koriste se adresa e-pošte i lozinka postojećeg korisnika. U tu svrhu pošaljite POST zahtjev, na primjer:

```bash
curl -i --header "Content-Type: application/json" \
     --request POST \
     --data '{"email":"api-user@example.com","password":"Str0ngPas$"}' \
     https://api.vadsro.eu/api/v1/auth/sign_in
```

### Preuzimanje popisa krajnjih kupaca

Da biste preuzeli popis krajnjih kupaca, pošaljite GET zahtjev, na primjer:

```bash
curl -i --header "access-token: *********************" \
 --header "token-type: Bearer" \
 --header "client: **********************" \
 --header "uid: api-user@example.com" \
 --request GET \
 --header "Content-Type: application/json" \
 --data '{"page":"2"}' \
 https://api.vadsro.eu/api/v1/customers
```

Podaci se preuzimaju po stranicama (`"total_pages": 8` – ukupan broj stranica, `"current_page": 2` – trenutačna stranica).

Podatke je potrebno ciklično preuzimati stranicu po stranicu:

```json
{"data":[
       {
        "id":13,
        "name":"Example National Sports Federation",
        "subdivision_type_name":"Unit Owner",
        "inn":"1000000042",
        "contact_number":"+49-30-5550100"
},
... ],
  "total_pages":8,
  "current_page":2,
  "next_page":3
}
```

Za daljnje preuzimanje podataka (arhiva vrijednosti) bit će potrebni sljedeći parametri:

- `"id": 13` (`"customer_id": "13"`) – identifikator (jedinstveni ključ) krajnjeg kupca u sustavu.

### Preuzimanje popisa mjernih mjesta

Da biste preuzeli popis mjernih mjesta, pošaljite GET zahtjev, na primjer:

```bash
curl -i --header "access-token: *********************" \
 --header "token-type: Bearer" \
 --header "client: **********************" \
 --header "uid: api-user@example.com" \
 --request GET \
 --header "Content-Type: application/json" \
 --data '{"page":"2"}' \
 https://api.vadsro.eu/api/v1/stations

```

Podaci se preuzimaju po stranicama (`"total_pages": 9` – ukupan broj stranica, `"current_page": 2` – trenutačna stranica).

Podatke je potrebno ciklično preuzimati stranicu po stranicu.

```json
{"data":[
{
"id":18,
        "name":"Example Beverages Production GmbH",
        "equipment_type_id":1,
        "equipment_brand_name":"BK",
        "phone":"+49-30-5550101",
        "equipment_id":61,
        "customer_id":14
    }
... ],
  "total_pages":9,
  "current_page":2,
  "next_page":3
}
```

Za daljnje preuzimanje podataka (arhiva vrijednosti) potrebni su sljedeći parametri:

- `"equipment_id": 61` – identifikator mjernog uređaja.

Za usklađivanje podataka sa šifrarnicima:

- `"customer_id": 14` – identifikator krajnjeg kupca;
- `"equipment_type_id": 1` – identifikator tipa konfiguracije mjernog uređaja.

### Preuzimanje karakteristika objekta

Da biste preuzeli karakteristike mjernog mjesta, pošaljite GET zahtjev s identifikatorom mjernog mjesta u putanji, na primjer:

```bash
curl -i --header "access-token: *********************" \
 --header "token-type: Bearer" \
 --header "client: **********************" \
 --header "uid: api-user@example.com" \
 --request GET \
 --header "Content-Type: application/json" \
 https://api.vadsro.eu/api/v1/stations/134/characteristics
```

`id` je identifikator mjernog mjesta dobiven pri preuzimanju popisa mjernih mjesta.

### Preuzimanje tipova mjernih uređaja

Da biste preuzeli tipove mjernih uređaja, pošaljite GET zahtjev, na primjer:

```bash
curl -i  --header "access-token: *********************" \
 --header "token-type: Bearer" \
 --header "client: **********************" \
 --header "uid: api-user@example.com" \
 --request GET \
--header "Content-Type: application/json"  \
--data '{"page":"1"}' \
 https://api.vadsro.eu/api/v1/equipment_types
```

Podatke je potrebno ciklično preuzimati prema sljedećim parametrima:

- `page` – broj stranice.

### Preuzimanje kanala

Da biste preuzeli kanale vezane uz tip mjernog uređaja, pošaljite GET zahtjev, na primjer:

```bash
curl -i  --header "access-token: *********************" \
 --header "token-type: Bearer" \
 --header "client: **********************" \
 --header "uid: api-user@example.com" \
 --request GET \
--header "Content-Type: application/json"  \
--data '{"equipment_type_id": "2", "page":"1"}' \
 https://api.vadsro.eu/api/v1/channel_archive_types
```

Podatke je potrebno ciklično preuzimati prema sljedećim parametrima:

- `equipment_type_id` – identifikator tipa konfiguracije uređaja;
- `page` – broj stranice.

### Preuzimanje poruka uređaja

Da biste preuzeli šifrarnik poruka (kodova događaja i pogrešaka) za tip mjernog uređaja, pošaljite GET zahtjev, na primjer:

```bash
curl -i --header "access-token: *********************" \
 --header "token-type: Bearer" \
 --header "client: **********************" \
 --header "uid: api-user@example.com" \
 --request GET \
 --header "Content-Type: application/json" \
 "https://api.vadsro.eu/api/v1/message_equipment_types?equipment_type_id=11&page=1"
```

Parametri filtra prosljeđuju se kao parametri upita u URL-u:

- `equipment_type_id` – identifikator tipa mjernog uređaja;
- `archive_type_id` – identifikator tipa arhive (po izboru, sužava skup rezultata);
- `page` – broj stranice.

### Preuzimanje arhiva očitanja

Da biste preuzeli arhive očitanja, pošaljite GET zahtjev, na primjer:

```bash
curl -i --header "access-token: *********************" \
 --header "token-type: Bearer" \
 --header "client: **********************" \
 --header "uid: api-user@example.com" \
 --request GET \
 --header "Content-Type: application/json" \
 --data '{"archive_type": "hourly", "equipment_id":"25",  "fp_end":"2021-02-20", "fp_start":"2021-02-01", "page":"1"}' \
 https://api.vadsro.eu/api/v1/channel_data
```

Podatke je potrebno ciklično preuzimati prema sljedećim parametrima:

- `equipment_id` – identifikator mjernog uređaja;
- `archive_type` – tip arhive (pogledajte šifrarnik);
- `fp_start` – početak vremenskog intervala;
- `fp_end` – kraj vremenskog intervala;
- `page` – broj stranice.

### Preuzimanje arhive za razdoblje

Da biste preuzeli arhivu za razdoblje, pošaljite GET zahtjev, na primjer:

```bash
curl -i --header "access-token: *********************" \
 --header "token-type: Bearer" \
 --header "client: **********************" \
 --header "uid: api-user@example.com" \
 --request GET \
 --header "Content-Type: application/json" \
 --data '{"archive_type": "hourly", "equipment_id":"25",  "fp_end":"2021-02-20", "fp_start":"2021-02-01", "page":"1", "channel_consolidation": "1"}' \
 https://api.vadsro.eu/api/v1/channel_data
```

Podatke je potrebno ciklično preuzimati prema sljedećim parametrima:

- `equipment_id` – identifikator mjernog uređaja;
- `archive_type` – tip arhive (pogledajte šifrarnik);
- `fp_start` – početak vremenskog intervala;
- `fp_end` – kraj vremenskog intervala;
- `page` – broj stranice;
- `channel_consolidation: 1` – parametar za objedinjeno preuzimanje.

### Preuzimanje konfiguracije mjerila

Da biste preuzeli konfiguraciju mjerila, pošaljite GET zahtjev, na primjer:

```bash
curl -i --header "access-token: *********************" \
 --header "token-type: Bearer" \
 --header "client: **********************" \
 --header "uid: api-user@example.com" \
 --request GET \
 --header "Content-Type: application/json" \
 --data '{"archive_type": "settings", "equipment_id":"25", "page":"1"}' \
 https://api.vadsro.eu/api/v1/channel_data
```

Podatke je potrebno ciklično preuzimati prema sljedećim parametrima:

- `equipment_id` – identifikator mjernog uređaja;
- `archive_type = “settings”`;
- `page` – broj stranice.

### Preuzimanje datuma posljednje komunikacijske sesije

Da biste preuzeli datum posljednje komunikacijske sesije mjernog mjesta, pošaljite GET zahtjev, na primjer:

```bash
curl -i --header "access-token: *********************" \
--header "token-type: Bearer" \
--header "client: **********************" \
 --header "uid: api-user@example.com" \
 --request GET  \
--header "Content-Type: application/json" \
--data '{ "id": "1816"}' https://api.vadsro.eu/api/v1/stations/last_seance_event_time
```

Podatke je potrebno preuzimati prema sljedećem parametru:

- `id` – identifikator mjernog mjesta.

### Preuzimanje komunikacijskih sesija

Da biste preuzeli komunikacijske sesije telemetrijskih modula, pošaljite GET zahtjev, na primjer:

```bash
curl -i --header "access-token: *********************" \
 --header "token-type: Bearer" \
 --header "client: **********************" \
 --header "uid: api-user@example.com" \
 --request GET \
 --header "Content-Type: application/json" \
 "https://api.vadsro.eu/api/v1/seances?telemetry_id=85&fp_start=2021-11-02&fp_end=2021-11-30&page=1"
```

Podatke je potrebno ciklično preuzimati prema sljedećim parametrima:

- `telemetry_id` – identifikator telemetrijskog modula;
- `fp_start` – početak vremenskog intervala;
- `fp_end` – kraj vremenskog intervala;
- `page` – broj stranice.

</Steps>

<Alert type="info">
  Nakon što izvršite gore navedene korake, [završite sesiju](/hr/api/v1#autentifikacija).
</Alert>