---
title: 'Diagnosticarea interfeței API'
description: Verificare de service a schimbului de date dintre AI Analytics și platforma dispozitivelor de măsurare, prin testarea fiecărei cereri pe care se bazează celelalte rapoarte.
section: AI Analytics
weight: 9
---

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

Verificare de service a schimbului de date dintre AI Analytics și platforma dispozitivelor de măsurare. Raportul trimite pe rând către platformă toate cererile pe care le folosesc celelalte rapoarte și arată care dintre ele primesc un răspuns normal și care se termină cu o eroare. Se adresează administratorului și asistenței tehnice: rulați-l când bănuiți o defecțiune a integrării și vedeți imediat unde s-a întrerupt conexiunea cu dispozitivul sau cu serverul.

<Alert type="info">
Este un instrument de service pentru administrator. Raportul este accesibil printr-un link direct, nu din lista generală de rapoarte afișată personalului de exploatare.
</Alert>

## Ce arată

Pentru fiecare tip de cerere către platformă – un rând cu rezultatul: ce endpoint a fost apelat, dacă serverul a răspuns cu succes, câte rânduri de date a returnat și ce câmpuri conținea primul rând (pentru a confirma că formatul datelor nu s-a schimbat).

| Elementul rândului | Ce înseamnă |
|---|---|
| Endpointul cererii | ce tip de date a fost verificat (autentificarea, lista parcului de dispozitive, nomenclatoarele, sesiunile de comunicație, arhivele citirilor, cartea tehnică a dispozitivului) |
| Stare | dacă serverul a răspuns cu succes sau a returnat o eroare |
| Număr de rânduri | câte înregistrări conține răspunsul |
| Eșantion de câmpuri | denumirile câmpurilor din prima înregistrare – semn că formatul nu s-a schimbat |

Culoarea rândului o stabilește codul de răspuns al serverului:

| Culoare | Ce înseamnă |
|---|---|
| Verde („200”) | cererea funcționează normal |
| Galben (eroare de drepturi de acces, cu excepția „nu a fost găsit”) | trebuie verificate drepturile de acces |
| Roșu (eroare de server sau lipsa unui răspuns în timp util) | o problemă pe partea de server |
| Gri („404” – nu a fost găsit) | această versiune a platformei nu are o astfel de cerere |

<Alert type="note">
Endpointuri precum `/api/v1/stations` și denumiri de câmpuri precum `archive_type` sunt identificatori tehnici ai cererilor și ai câmpurilor platformei, nu setări pentru personalul de exploatare.
</Alert>

## Cum se calculează

Raportul trimite pe rând către platformă toate cererile pe care le folosesc celelalte rapoarte: autentificarea, lista parcului de dispozitive, nomenclatoarele (tipuri de dispozitive, furnizori, consumatori), sesiunile de comunicație (în patru variante de parametri), arhivele citirilor (orare, zilnice, lunare, de setări), arhivele regimurilor anormale și jurnalele de evenimente, precum și cartea tehnică a dispozitivului. Pentru fiecare apel se înregistrează endpointul, răspunsul serverului, numărul de rânduri și un eșantion de câmpuri. Dacă este specificat un anumit punct de măsurare, arhivele regimurilor anormale se verifică suplimentar pentru acesta.

## Parametrii de rulare

| Parametru | Implicit | Semnificație |
|---|---|---|
| Identificatorul punctului de măsurare pentru verificarea arhivei regimurilor anormale (opțional) | preluat din context | dacă este specificat – verificarea se face pentru acest punct de măsurare; dacă este gol – se ia primul punct de măsurare din lista parcului de dispozitive |

## Cum se interpretează raportul

Urmăriți culorile rândurilor. Dacă toate sunt verzi, schimbul de date funcționează corect. Rândurile galbene arată că serverul este disponibil, dar nu returnează date fără drepturile necesare – un motiv pentru a verifica accesul. Rândurile roșii indică o defecțiune pe partea de server și se tratează primele. Rândurile gri („nu a fost găsit”) sunt adesea normale: nu toate dispozitivele acceptă toate tipurile de arhive, astfel că lipsa arhivelor regimurilor anormale la un anumit dispozitiv nu este o eroare.

Rețineți o particularitate a autentificării: platforma reutilizează timp de aproximativ două săptămâni un permis de acces obținut anterior, așa că verificarea autentificării reușește de obicei chiar și fără o reautentificare efectivă pe server.

## Rapoarte conexe

Acest raport este autonom și nu depinde de nimic. Toate celelalte rapoarte la nivelul parcului de dispozitive folosesc aceleași cereri către platformă pe care le verifică el – de aceea, când acestea eșuează, diagnosticarea începe de aici.