---
title: 'Diagnostika API'
description: Servisní kontrola výměny dat mezi AI Analytics a platformou měřicích zařízení, která prověřuje každý požadavek, na němž závisí ostatní reporty.
section: AI Analytics
weight: 9
---

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

Servisní kontrola výměny dat mezi AI Analytics a platformou měřicích zařízení. Report postupně volá všechny požadavky platformy, které využívají ostatní reporty, a ukazuje, které z nich odpovídají normálně a které vracejí chybu. Cílovým publikem je administrátor a technická podpora: spusťte jej, když máte podezření na selhání integrace, a okamžitě uvidíte, kde je spojení se zařízením nebo serverem přerušeno.

<Alert type="info">
  Jde o servisní nástroj pro administrátora. Je dostupný prostřednictvím přímého odkazu, nikoli z
  obecného seznamu reportů zobrazeného operátorům.
</Alert>

## Co zobrazuje

Pro každý druh požadavku platformy — řádek s výsledkem: který endpoint byl volán, zda server odpověděl úspěšně, kolik řádků dat vrátil a jaká pole byla v prvním řádku (pro potvrzení, že se formát dat nezměnil).

| Prvek řádku        | Co znamená                                                                                                              |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| Endpoint požadavku | jaký druh dat byl zkontrolován (přihlášení, seznam flotily, číselníky, relace spojení, čtení archivů, pasport zařízení) |
| Stav               | zda server odpověděl úspěšně, nebo vrátil chybu                                                                         |
| Počet řádků        | kolik záznamů dorazilo v odpovědi                                                                                       |
| Ukázky polí        | názvy polí z prvního záznamu — známka toho, že se formát nezměnil                                                       |

Barva řádku se určuje podle kódu odpovědi serveru:

| Barva                                             | Co znamená                                         |
| ------------------------------------------------- | -------------------------------------------------- |
| Zelená («200»)                                    | požadavek funguje normálně                         |
| Žlutá (chyba oprávnění, kromě «nenalezeno»)       | je třeba zkontrolovat přístupová práva             |
| Červená (chyba serveru nebo žádná včasná odpověď) | problém na straně serveru                          |
| Šedá («404» — nenalezeno)                         | takový požadavek v této verzi platformy neexistuje |

<Alert type="note">
  Endpointy jako `/api/v1/stations` a názvy polí jako `archive_type` jsou technické identifikátory
  požadavků a polí platformy, nikoli nastavení pro operátora.
</Alert>

## Jak se počítá

Report postupně volá všechny požadavky platformy, které využívají ostatní reporty: přihlášení, seznam flotily, číselníky (typy zařízení, dodavatelské společnosti, zákazníci), relace spojení (ve čtyřech parametrických variantách), čtení archivů (hodinové, denní, měsíční, nastavení), archivy mimořádných situací a protokoly událostí, jakož i pasport zařízení. Pro každé volání se zaznamenává endpoint, odpověď serveru, počet řádků a ukázka polí. Je-li nastaven konkrétní uzel, jsou pro tento uzel navíc zkontrolovány archivy mimořádných situací.

## Parametry spuštění

| Parametr                                                  | Výchozí hodnota     | Význam                                                                                                    |
| --------------------------------------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------- |
| ID uzlu pro sondu archivu mimořádných situací (volitelné) | převzato z kontextu | je-li nastaveno — kontrola proběhne na tomto uzlu; je-li prázdné — vezme se první uzel ze seznamu flotily |

## Jak jej číst

Sledujte barvy řádků. Vše zelené — výměna dat je v pořádku. Žluté řádky znamenají, že server je na svém místě, ale bez potřebných práv data nevrací — důvod ke kontrole přístupu. Červené řádky představují selhání na straně serveru a řeší se jako první. Šedé řádky («nenalezeno») jsou často normální: ne všechna zařízení podporují všechny druhy archivů, takže absence archivů mimořádných situací u konkrétního zařízení není chybou.

Pozor na zvláštnost přihlašování: platforma znovu používá dříve získaný přístup po dobu zhruba dvou týdnů, takže kontrola přihlášení je obvykle úspěšná i bez skutečného opětovného přihlášení na serveru.

## Související reporty

Tento report je soběstačný a na ničem nezávisí. Všechny ostatní reporty flotily používají tytéž požadavky platformy, které kontroluje — takže když selžou, diagnostiku je třeba začít právě zde.