خطای AI_APICall

این خطا زمانی رخ می‌دهد که فراخوانی یک API با شکست مواجه شود.

• url: نشانی کامل (URL) درخواست HTTP که هنگام فراخوانی API با خطا مواجه شده است.
• requestBodyValues: داده‌های ارسال‌شده در بدنه (payload) درخواست، که معمولاً شامل پارامترها یا مقادیر مورد نیاز برای عملکرد API است.
• statusCode: کد وضعیت HTTP که توسط سرور API بازگردانده شده؛ این کد نشان‌دهنده موفقیت یا نوع خطای رخ‌داده در پاسخ به درخواست است (مثلاً 200، 400، 500 و غیره).
• responseHeaders: مجموعه هدرهای HTTP موجود در پاسخ API، شامل اطلاعات متا مانند نوع محتوا، وضعیت احراز هویت، نرخ محدودیت و غیره.
• responseBody: محتوای اصلی پاسخ بازگردانده‌شده از API، که می‌تواند شامل داده‌های خروجی یا پیام خطا باشد.
• isRetryable: بیانگر این است که آیا با توجه به نوع خطا (مثلاً خطاهای موقتی مانند 503 یا 429)، امکان تلاش مجدد خودکار برای این درخواست وجود دارد یا خیر.
• data: اطلاعات یا متادیتای اضافی مرتبط با خطا که ممکن است برای اشکال‌زدایی (debugging) یا ثبت گزارش‌های خطا (logging) استفاده شود.

برای بررسی اینکه آیا یک خطا نمونه‌ای از AI_APICallError است یا نه، می‌توانید از روش زیر استفاده کنید:

import { APICallError } from 'ai';

if (APICallError.isInstance(error)) {
  // Handle the error}