Support Hub/API & Integrations/کدهای وضعیت API: معنی هر خطا و روش رفع آن
Machine translation. This page was translated by AI from the English article and has not been reviewed by a person yet. Read the English original
Developer

کدهای وضعیت API: معنی هر خطا و روش رفع آن

هر پاسخ RESTful API یک StatusCode عددی دارد. کد 0 یعنی موفقیت. پاسخ‌های callback متفاوت‌اند: سرور شما همیشه با {"status":"done"} و HTTP 200 پاسخ می‌دهد.

کدوضعیتمعنیچه کاری انجام دهید
0Successعملیات کامل شد.کاری لازم نیست.
1Invalid Request Dataبدنه JSON نادرست است یا مقادیر نامعتبر دارد.JSON خام را با UTF-8 و هدر Content-Type: application/json بفرستید. مقادیر را بررسی کنید.
2Invalid Service Tag IDپارامتر کوئری stgid با هیچ دستگاه ثبت‌شده‌ای مطابقت ندارد.Service Tag ID را دوباره از حساب API Monitor خود کپی کنید.
3Invalid Requestدرخواست از قالب آن عملیات پیروی نمی‌کند.آن را با درخواست نمونه همان عملیات مقایسه کنید.
4Invalid Encryptionرمزگشایی payload با AES-256 ممکن نبود.کلید رمزگذاری و کدگذاری Base64 را بررسی کنید.
5Device Offlineدستگاه هدف اکنون به Cams متصل نیست.صفحه Device Status را بررسی کنید. دستور در صف می‌ماند و با اتصال دوباره دستگاه تحویل داده می‌شود.
6Operation Timeoutدستگاه دستور را به‌موقع تأیید نکرد.بررسی کنید دستگاه آنلاین باشد، سپس دوباره تلاش کنید.
7Invalid Auth TokenAuthToken با توکنِ تنظیم‌شده برای دستگاه مطابقت ندارد.توکن ۳۲ کاراکتری را از API Monitor استفاده کنید.
8User Already Existsافزودن UserID‌ای که از قبل روی دستگاه هست تلاش شد.به‌جای آن کاربر را به‌روزرسانی کنید یا ابتدا کاربر را حذف کنید.
9User Not FoundUserID روی دستگاه نیست.UserID را بررسی کنید. در صورت نیاز ابتدا کاربر را اضافه کنید.
10Template Errorقالب بیومتریک خراب است یا در قالب پشتیبانی‌نشده است.داده Base64، Size و Index قالب را بررسی کنید.
11Device Memory Fullدستگاه به حد مجاز کاربران یا قالب‌ها رسیده است.کاربران یا قالب‌هایی را که دیگر لازم نیستند حذف کنید.
13Invalid Security Keyکلید امنیتی با کلید موجود در API Monitor مطابقت ندارد.در هر دو طرف از یک کلید استفاده کنید.
15Feature Not Supportedاین مدل دستگاه یا حالت اتصال از این عملیات پشتیبانی نمی‌کند.حالت اتصال را بررسی کنید. حالت‌های DB Pull و File Processing فقط push حضور و غیاب را پشتیبانی می‌کنند، نه دستورهای RESTful را.
999Unknown Errorیک خطای غیرمنتظره.با پشتیبانی Cams تماس بگیرید و OperationID را ذکر کنید.

نکات

  • برای هر درخواست REST یک OperationID یکتا بسازید. پاسخ آن را تکرار می‌کند، پس می‌توانید درخواست و پاسخ را تطبیق دهید.
  • دستورهای REST حدود ۱۵ ثانیه طول می‌کشد تا به دستگاه برسند.
  • کدهای 12 و 14 استفاده نمی‌شوند.

مرتبط: Callback URL not receiving data، Add or delete users in bulk.

کمک می‌خواهید؟ به support@camsbiometrics.com ایمیل بزنید و OperationID و StatusCode را بفرستید.

Was this article helpful?