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