---
title: 'Diagnostika API'
description: Servisná kontrola výmeny dát medzi AI Analytics a platformou meracích prístrojov, ktorá preveruje každý dotaz, na ktorom závisia ostatné výkazy.
section: AI Analytics
weight: 9
---

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

Servisná kontrola výmeny dát medzi AI Analytics a platformou meracích prístrojov. Výkaz sa postupne, jeden po druhom, obracia na všetky platformové dotazy, ktoré používajú ostatné výkazy, a ukazuje, ktoré z nich odpovedajú normálne a ktoré vracajú chybu. Adresátom je administrátor a technická podpora: spustite ho pri podozrení na poruchu integrácie a hneď uvidíte, kde je prerušené spojenie s prístrojom alebo serverom.

<Alert type="info">
  Toto je servisný nástroj pre administrátora. Je dostupný cez priamy odkaz, nie zo všeobecného
  zoznamu výkazov zobrazeného operátorom.
</Alert>

## Čo zobrazuje

Pre každý druh platformového dotazu — riadok s výsledkom: ktorý endpoint sa volal, či server odpovedal úspešne, koľko riadkov dát vrátil a aké polia boli v prvom riadku (aby sa potvrdilo, že formát dát sa nezmenil).

| Prvok riadka    | Čo znamená                                                                                                   |
| --------------- | ------------------------------------------------------------------------------------------------------------ |
| Endpoint dotazu | aký druh dát sa preveroval (prihlásenie, zoznam parku, číselníky, spojenia, archívy odpočtov, pas prístroja) |
| Stav            | či server odpovedal úspešne alebo vrátil chybu                                                               |
| Počet riadkov   | koľko záznamov prišlo v odpovedi                                                                             |
| Príklady polí   | názvy polí z prvého záznamu — znak, že formát sa nezmenil                                                    |

Farbu riadka určuje kód odpovede servera:

| Farba                                                 | Čo znamená                                       |
| ----------------------------------------------------- | ------------------------------------------------ |
| Zelená («200»)                                        | dotaz funguje normálne                           |
| Žltá (chyba práv, okrem «nenájdené»)                  | treba skontrolovať prístupové práva              |
| Červená (serverová chyba alebo žiadna včasná odpoveď) | problém na strane servera                        |
| Sivá («404» — nenájdené)                              | takýto dotaz v tejto verzii platformy neexistuje |

<Alert type="note">
  Endpointy ako `/api/v1/stations` a názvy polí ako `archive_type` sú technické identifikátory
  dotazov a polí platformy, nie nastavenia pre operátora.
</Alert>

## Ako sa počíta

Výkaz sa postupne, jeden po druhom, obracia na všetky platformové dotazy, ktoré používajú ostatné výkazy: prihlásenie, zoznam parku, číselníky (typy prístrojov, distribučné organizácie, klienti), spojenia (v štyroch variantoch parametrov), archívy odpočtov (hodinový, denný, mesačný, nastavenia), archívy neštandardných situácií a denníky udalostí, ako aj pas prístroja. Pre každé volanie sa zaznamenáva endpoint, odpoveď servera, počet riadkov a príklad polí. Ak je zadaný konkrétny uzol, dodatočne sa preverujú archívy neštandardných situácií práve preň.

## Parametre spustenia

| Parameter                                                        | Predvolené          | Čo znamená                                                                                        |
| ---------------------------------------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------- |
| ID uzla na kontrolu archívov neštandardných situácií (voliteľné) | berie sa z kontextu | ak je zadaný — kontrola ide podľa tohto uzla; ak je prázdne — berie sa prvý uzol zo zoznamu parku |

## Ako čítať výsledok

Pozerajte na farbu riadkov. Samé zelené — výmena dát je v poriadku. Žlté riadky znamenajú, že server je na mieste, ale neodovzdáva dáta bez potrebných práv — je to podnet na kontrolu prístupu. Červené riadky sú porucha na strane servera a riešia sa v prvom rade. Sivé riadky («nenájdené») sú často normálne: nie všetky prístroje podporujú všetky druhy archívov, takže absencia neštandardných archívov u konkrétneho prístroja nie je chyba.

Berte do úvahy osobitosť prihlásenia: platforma okolo dvoch týždňov opätovne používa skôr získanú vstupenku, preto je kontrola prihlásenia zvyčajne úspešná aj bez reálneho opätovného prihlásenia na server.

## Súvisiace výkazy

Tento výkaz je samostatný a od ničoho nezávisí. Všetky ostatné výkazy parku používajú tie isté platformové dotazy, ktoré preveruje — preto pri ich poruche sa diagnostiku oplatí začať odtiaľto.