---
title: 'عیبیابی API'
description: بررسی سرویسی تبادل داده میان AI Analytics و پلتفرم دستگاههای اندازهگیری، با آزمودن هر درخواستی که سایر گزارشها به آن متکیاند.
section: AI Analytics
weight: 9
---
import Alert from '@/components/docs/Alert.astro';
بررسی سرویسی تبادل داده میان AI Analytics و پلتفرم دستگاههای اندازهگیری. گزارش بهنوبت همه درخواستهای پلتفرم را که سایر گزارشها استفاده میکنند فرامیخواند و نشان میدهد کدامیک عادی پاسخ میدهند و کدام با خطا بازمیگردند. مخاطب آن مدیر و پشتیبانی فنی است: هنگام ظن به اختلال یکپارچهسازی آن را اجرا کنید و بیدرنگ ببینید کجا ارتباط با دستگاه یا سرور قطع شده است.
این یک ابزار سرویسی برای مدیر است. بهجای فهرست کلی گزارشهایی که به اپراتورها نشان داده میشود،
با پیوند مستقیم در دسترس است.
## چه چیزی نشان میدهد
برای هر نوع درخواست پلتفرم — یک سطر با نتیجه: کدام endpoint فراخوانده شد، آیا سرور موفق پاسخ داد، چند سطر داده برگرداند و چه فیلدهایی در سطر اول بودند (تا مطمئن شویم قالب داده تغییر نکرده است).
| عنصر سطر | معنا |
| ---------------- | ---------------------------------------------------------------------------------------------------------------- |
| endpoint درخواست | چه نوع دادهای بررسی شد (ورود به سیستم، فهرست ناوگان، دفترچهها، جلسات ارتباطی، آرشیوهای قرائت، شناسنامه دستگاه) |
| وضعیت | آیا سرور موفق پاسخ داد یا خطا برگرداند |
| تعداد سطر | چند رکورد در پاسخ آمد |
| نمونه فیلدها | نام فیلدهای رکورد اول — نشانهای که قالب تغییر نکرده است |
رنگ سطر را کد پاسخ سرور تعیین میکند:
| رنگ | معنا |
| -------------------------------------- | ------------------------------------------- |
| سبز («200») | درخواست عادی کار میکند |
| زرد (خطای دسترسی، بهجز «یافت نشد») | باید حقوق دسترسی بررسی شود |
| قرمز (خطای سروری یا نبود پاسخ بهموقع) | مشکل سمت سرور |
| خاکستری («404» — یافت نشد) | چنین درخواستی در این نسخه پلتفرم وجود ندارد |
endpointهایی مانند `/api/v1/stations` و نام فیلدهایی مانند `archive_type` شناسههای فنی درخواستها
و فیلدهای پلتفرماند، نه تنظیماتی برای اپراتور.
## چگونه محاسبه میشود
گزارش بهنوبت همه درخواستهای پلتفرم را که سایر گزارشها استفاده میکنند فرامیخواند: ورود به سیستم، فهرست ناوگان، دفترچهها (انواع دستگاه، سازمانهای تأمین منابع، مشتریان)، جلسات ارتباطی (در چهار حالت پارامتر)، آرشیوهای قرائت (ساعتی، روزانه، ماهانه، تنظیمات)، آرشیوهای وضعیتهای اضطراری و دفترهای رویداد، و نیز شناسنامه دستگاه. برای هر فراخوان، endpoint، پاسخ سرور، تعداد سطر و نمونه فیلدها ثبت میشود. اگر نقطهای مشخص تعیین شده باشد، علاوه بر آن آرشیوهای وضعیتهای اضطراری برای همان نقطه بررسی میشوند.
## پارامترهای اجرا
| پارامتر | پیشفرض | معنا |
| --------------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------ |
| شناسه نقطه برای بررسی آرشیو اضطراری (اختیاری) | از زمینه گرفته میشود | اگر تعیین شود — بررسی روی این نقطه انجام میشود؛ اگر خالی باشد — نخستین نقطه فهرست ناوگان گرفته میشود |
## چگونه نتیجه را بخوانیم
به رنگ سطرها نگاه کنید. سراسر سبز — تبادل داده سالم است. سطرهای زرد یعنی سرور سرجایش است اما بدون حقوق لازم دادهای بازنمیگرداند — دلیلی برای بررسی دسترسی. سطرهای قرمز اختلال سمت سرور است و در درجه نخست بررسی میشوند. سطرهای خاکستری («یافت نشد») اغلب عادیاند: همه دستگاهها همه انواع آرشیو را پشتیبانی نمیکنند، پس نبود آرشیوهای اضطراری در یک دستگاه مشخص خطا نیست.
به یک ویژگی ورود به سیستم توجه کنید: پلتفرم مجوز پیشتر گرفتهشده را حدود دو هفته بازاستفاده میکند، پس بررسی ورود معمولاً موفق است حتی بدون ورود واقعی مجدد به سرور.
## گزارشهای مرتبط
این گزارش مستقل است و به چیزی وابسته نیست. همه گزارشهای دیگر ناوگان از همان درخواستهای پلتفرم استفاده میکنند که این گزارش بررسی میکند — پس هنگام اختلال آنها، عیبیابی را باید از همینجا آغاز کرد.