مستندات توسعه‌دهندگان
خطاها و کدهای پاسخ
با کدهای خطای API چارتیکال آشنا شوید، علت هر خطا را بررسی کنید و راهکار مناسب برای رفع آن را پیدا کنید.
چطور خطاها را مدیریت کنید؟
ابتدا وضعیت HTTP را بررسی کنید و سپس از کد خطا برای تشخیص دقیق‌تر علت استفاده کنید. کد خطا برای تشخیص برنامه‌ای مناسب است؛ پیام خطا برای نمایش به کاربر کاربرد دارد.
18 نتیجه
خطاهای احراز هویت و دسترسی
کلید API نامعتبر است
invalid_api_keyکلید API ارسال نشده است یا اعتبار لازم برای احراز هویت را ندارد.
کاربر پیدا نشد
user_not_foundکاربر مرتبط با کلید API پیدا نشده است.
کلید API غیرفعال است
key_not_activeکلید API شناسایی شده است، اما در حال حاضر فعال نیست.
دسترسی به دستیار مجاز نیست
access_denied_assistantکلید یا حساب فعلی اجازه استفاده از دستیار موردنظر را ندارد.
خطاهای درخواست
فرمت پیام نامعتبر
invalid_message_formatساختار messages با فرمت مورد انتظار API سازگار نیست.
پارامتر درخواست نامعتبر
invalid_request_parameterساختار درخواست یا یکی از مقادیر ارسالی معتبر نیست.
تنظیمات جست‌وجو نامعتبر
search_not_validمقدار مربوط به تنظیمات جست‌وجو معتبر نیست.
messages آرایه نیست
messages_not_arrayمقدار فیلد messages به‌صورت آرایه ارسال نشده است.
tools شیء نیست
tools_not_objectمقدار فیلد tools با نوع داده‌ی مورد انتظار مطابقت ندارد.
خطاهای سرویس‌دهنده و پردازش
خطای سرویس هوش مصنوعی
ai_errorپردازش درخواست توسط سرویس هوش مصنوعی با خطا مواجه شده است.
خطای داخلی سرویس‌دهنده
internal_provider_errorسرویس‌دهنده‌ی بالادستی نتوانسته درخواست را به‌درستی پردازش کند.
خطای ناشناخته
unknown_errorخطایی پیش‌بینی‌نشده رخ داده است و علت مشخصی برای آن گزارش نشده است.
خطای قیمت‌گذاری
price_errorدر دریافت یا پردازش اطلاعات قیمت‌گذاری سرویس‌دهنده مشکلی رخ داده است.
دریافت فایل ناموفق
download_file_failedسرویس نتوانسته فایل موردنیاز برای پردازش درخواست را دریافت کند.
خطاهای منابع
تنظیمات یا منبع جست‌وجو پیدا نشد
search_not_foundمنبع یا مقدار موردنیاز برای جست‌وجو پیدا نشده است.
مدل پیدا نشد
model_not_foundمدل مشخص‌شده معتبر نیست یا توسط API شناسایی نشده است.
دسته‌بندی پیدا نشد
category_not_foundدسته‌بندی مشخص‌شده در درخواست پیدا نشده است.
دستیار پیدا نشد
assistant_not_foundدستیار موردنظر با شناسه یا slug ارسالی پیدا نشده است.
نکته برای توسعه‌دهندگان
در کد خود به متن پیام خطا وابسته نشوید؛ متن پیام ممکن است تغییر کند یا بر اساس زبان متفاوت باشد. برای تشخیص خطا از code و برای دسته‌بندی عمومی از وضعیت HTTP استفاده کنید.
برای یکپارچه‌سازی به راهنمایی نیاز دارید؟
اگر در ارسال درخواست، احراز هویت یا استفاده از دستیارها به مشکل برخوردید، از راهنماهای فنی استفاده کنید یا با پشتیبانی چارتیکال ارتباط بگیرید.