---
title: 'Dijagnostika API-ja'
description: Servisna provjera razmjene podataka između AI analitike i platforme za mjerne uređaje – ispituje se svaki zahtjev na koji se oslanjaju ostala izvješća.
section: AI Analytics
weight: 9
---

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

Servisna provjera razmjene podataka između AI analitike i platforme za mjerne uređaje. Izvješće redom šalje platformi sve zahtjeve koje koriste ostala izvješća i prikazuje koji se od njih izvršavaju normalno, a koji vraćaju pogrešku. Namijenjeno je administratoru i tehničkoj podršci: pokrenite ga kada posumnjate da je integracija zakazala i odmah ćete vidjeti gdje je prekinuta veza s uređajem ili poslužiteljem.

<Alert type="info">
Ovo je servisni alat za administratora. Dostupan je putem izravne poveznice, a ne s općeg popisa izvješća koji se prikazuje operaterima.
</Alert>

## Što prikazuje

Za svaku vrstu zahtjeva prema platformi prikazuje se redak s rezultatom: koja je krajnja točka (endpoint) pozvana, je li poslužitelj uspješno odgovorio, koliko je redaka podataka vratio i koja su polja bila u prvom retku (kako bi se potvrdilo da format podataka nije promijenjen).

| Element retka | Što znači |
|---|---|
| Krajnja točka zahtjeva | koja je vrsta podataka provjerena (prijava, popis uređaja na terenu, šifrarnici, komunikacijske sesije, arhive očitanja, putovnica uređaja) |
| Stanje | je li poslužitelj uspješno odgovorio ili je vratio pogrešku |
| Broj redaka | koliko je zapisa stiglo u odgovoru |
| Uzorci polja | nazivi polja iz prvog zapisa – znak da se format nije promijenio |

Boju retka određuje kod odgovora poslužitelja:

| Boja | Što znači |
|---|---|
| Zelena („200”) | zahtjev radi normalno |
| Žuta (pogreška pristupa, osim „nije pronađeno”) | potrebno je provjeriti prava pristupa |
| Crvena (pogreška poslužitelja ili odgovor nije stigao na vrijeme) | problem na strani poslužitelja |
| Siva („404” – nije pronađeno) | u ovoj verziji platforme takav zahtjev ne postoji |

<Alert type="note">
Krajnje točke poput `/api/v1/stations` i nazivi polja poput `archive_type` tehnički su identifikatori zahtjeva i polja platforme, a ne postavke za operatera.
</Alert>

## Kako se izračunava

Izvješće redom šalje platformi sve zahtjeve koje koriste ostala izvješća: za prijavu, popis uređaja na terenu, šifrarnike (tipovi uređaja, opskrbljivači, krajnji kupci), komunikacijske sesije (u četiri varijante parametara), arhive očitanja (satne, dnevne, mjesečne, postavke), arhive nenormalnih režima rada i dnevnike događaja, kao i za putovnicu uređaja. Za svaki poziv bilježe se krajnja točka, odgovor poslužitelja, broj redaka i uzorak polja. Ako je zadano određeno mjerno mjesto, za njega se dodatno provjeravaju arhive nenormalnih režima rada.

## Parametri pokretanja

| Parametar | Zadano | Značenje |
|---|---|---|
| ID mjernog mjesta za provjeru arhive nenormalnih režima rada (po izboru) | iz konteksta | ako je zadan – provjerava se to mjerno mjesto; ako je prazan – uzima se prvo mjerno mjesto s popisa uređaja na terenu |

## Kako ga tumačiti

Pogledajte boje redaka. Ako su svi retci zeleni, razmjena podataka funkcionira ispravno. Žuti retci znače da je poslužitelj dostupan, ali da bez potrebnih prava ne vraća podatke – to je razlog za provjeru pristupa. Crveni retci označavaju kvar na strani poslužitelja i njima se treba najprije pozabaviti. Sivi retci („nije pronađeno”) često su normalna pojava: ne podržavaju svi uređaji sve vrste arhiva, pa izostanak arhiva nenormalnih režima rada na određenom uređaju nije pogreška.

Imajte na umu jednu osobitost prijave: platforma oko dva tjedna ponovno koristi prethodno dobiveni pristupni token, pa je provjera prijave obično uspješna čak i kada se ponovna prijava na poslužitelj zapravo ne obavi.

## Povezana izvješća

Ovo izvješće je samostalno i ne ovisi ni o čemu. Sva ostala izvješća na razini skupa uređaja koriste iste zahtjeve prema platformi koje ono provjerava – zato, kada zakažu, dijagnostiku treba započeti upravo odavde.