---
title: 'Dijagnostika interfejsa API'
description: Servisna provera razmene podataka između AI analitike i platforme za merne uređaje – ispituje se svaki zahtev na koji se oslanjaju ostali izveštaji.
section: AI Analytics
weight: 9
---

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

Servisna provera razmene podataka između AI analitike i platforme za merne uređaje. Izveštaj redom šalje platformi sve zahteve koje koriste ostali izveštaji i pokazuje koji se od njih izvršavaju normalno, a koji vraćaju grešku. Namenjen je administratoru i tehničkoj podršci: pokrenite ga kada posumnjate da je integracija otkazala i odmah ćete videti gde je prekinuta veza sa uređajem ili serverom.

<Alert type="info">
Ovo je servisni alat za administratora. Dostupan je preko direktnog linka, a ne sa opšteg spiska izveštaja koji se prikazuje operaterima.
</Alert>

## Šta prikazuje

Za svaku vrstu zahteva ka platformi prikazuje se red sa rezultatom: koja je krajnja tačka (endpoint) pozvana, da li je server uspešno odgovorio, koliko je redova podataka vratio i koja su polja bila u prvom redu (da bi se potvrdilo da format podataka nije promenjen).

| Element reda | Šta znači |
|---|---|
| Krajnja tačka zahteva | koja je vrsta podataka proverena (prijava, spisak parka uređaja, šifarnici, komunikacione sesije, arhive očitavanja, pasoš uređaja) |
| Stanje | da li je server uspešno odgovorio ili je vratio grešku |
| Broj redova | koliko je zapisa stiglo u odgovoru |
| Uzorci polja | nazivi polja iz prvog zapisa – znak da se format nije promenio |

Boju reda određuje kod odgovora servera:

| Boja | Šta znači |
|---|---|
| Zelena („200”) | zahtev radi normalno |
| Žuta (greška pristupa, osim „nije pronađeno”) | potrebno je proveriti prava pristupa |
| Crvena (greška servera ili odgovor nije stigao na vreme) | problem na strani servera |
| Siva („404” – nije pronađeno) | u ovoj verziji platforme takav zahtev ne postoji |

<Alert type="note">
Krajnje tačke poput `/api/v1/stations` i nazivi polja poput `archive_type` tehnički su identifikatori zahteva i polja platforme, a ne podešavanja za operatera.
</Alert>

## Kako se izračunava

Izveštaj redom šalje platformi sve zahteve koje koriste ostali izveštaji: za prijavu, spisak parka uređaja, šifarnike (tipovi uređaja, snabdevači, potrošači), komunikacione sesije (u četiri varijante parametara), arhive očitavanja (satne, dnevne, mesečne, podešavanja), arhive nenormalnih režima rada i dnevnike događaja, kao i za pasoš uređaja. Za svaki poziv beleže se krajnja tačka, odgovor servera, broj redova i uzorak polja. Ako je zadato konkretno merno mesto, za njega se dodatno proveravaju arhive nenormalnih režima rada.

## Parametri pokretanja

| Parametar | Podrazumevano | Značenje |
|---|---|---|
| ID mernog mesta za proveru arhive nenormalnih režima rada (opciono) | iz konteksta | ako je zadat – proverava se ovo merno mesto; ako je prazan – uzima se prvo merno mesto sa spiska parka uređaja |

## Kako tumačiti izveštaj

Pogledajte boje redova. Ako su svi redovi zeleni, razmena podataka funkcioniše ispravno. Žuti redovi znače da je server dostupan, ali da bez potrebnih prava ne vraća podatke – to je povod da proverite pristup. Crveni redovi označavaju otkaz na strani servera i njima se treba najpre pozabaviti. Sivi redovi („nije pronađeno”) često su normalna pojava: ne podržavaju svi uređaji sve vrste arhiva, pa izostanak arhiva nenormalnih režima rada kod određenog uređaja nije greška.

Imajte u vidu jednu osobenost prijave: platforma oko dve nedelje ponovo koristi ranije dobijeni pristupni token, pa je provera prijave obično uspešna čak i kada se ponovna prijava na server zapravo ne obavi.

## Povezani izveštaji

Ovaj izveštaj je samostalan i ne zavisi ni od čega. Svi ostali izveštaji na nivou parka uređaja koriste iste zahteve ka platformi koje on proverava – zato, kada otkažu, dijagnostiku treba početi upravo odavde.