Translated from the English article and reviewed by a person. Read the English original
Fix
Callback URL داده دریافت نمیکند: چکلیست
اگر پانچها به callback URL شما نمیرسند، این بررسیها را بهترتیب انجام دهید.
- آیا دستگاه به Cams میرسد؟ صفحه Device Status را باز کنید. اگر دستگاه آفلاین است، Why a device shows offline را ببینید.
- آیا URL درست است؟ callback URL ذخیرهشده در حساب API Monitor خود را بررسی کنید.
- آیا سرور شما درست پاسخ میدهد؟ همیشه با
{"status":"done"}و وضعیت HTTP 200 پاسخ دهید، حتی اگر پردازش خودتان با شکست روبهرو شود. کارهای سنگین را بعداً در یک صف انجام دهید تا Cams هرگز منتظر نماند. - آیا endpoint از اینترنت در دسترس است؟ برای محیط عملیاتی از پورت 80 (HTTP) یا 443 (HTTPS) استفاده کنید. پورت 8123 فقط برای آزمایش است. این پورتها را در فایروال مجاز کنید.
- آیا HTTPS درست راهاندازی شده است؟ HTTPS با گواهی SSL معتبر روی پورت 443 پشتیبانی و توصیه میشود. مطمئن شوید گواهی بدون راهاندازی مجدد سرور تمدید میشود.
- آیا بدنه را بهصورت JSON خام میخوانید؟ درخواستها JSON خام با UTF-8 هستند، نه فیلدهای فرم.
- آیا بررسی AuthToken درست است؟ هر callback یک AuthToken دارد. آن را با توکن تنظیمشده در API Monitor مقایسه کنید و در صورت عدم تطابق رد کنید. مطمئن شوید با مقایسه با توکن اشتباه، درخواستهای درست را رد نمیکنید.
- آیا رمزگذاری روشن است؟ اگر Security Key در API Monitor تنظیم شده باشد، payloadها رمزگذاری میشوند. سرور شما باید آنها را با همان کلید رمزگشایی کند. اگر قصد استفاده از رمزگذاری نداشتید، کلید را حذف کنید.
- آیا تحویل متوقف شده است؟ اگر سرور شما پاسخ غیرمنتظره داده باشد، تحویل تا سه بار تلاش میشود و سپس متوقف میشود و هر سه ساعت یک تلاش جدید انجام میشود. سرور را اصلاح کنید و صف را از صفحه Device Status دوباره راهاندازی کنید. Punches not transmitting or queuing up را ببینید.
آزمایش کنید
- با Postman یا cURL یک POST آزمایشی به URL خود بفرستید.
- برای آزمایش از رایانه خودتان، از یک تونل مانند ngrok استفاده کنید. Testing callback URLs from your local environment را ببینید.
- برای ساخت گیرنده، Building a biometric callback receiver را ببینید.
رویدادهایی که تحویل نشدهاند نگه داشته میشوند و پس از بازگشت سرور شما ارسال میشوند. Punches made while a device was offline را ببینید.
هنوز مشکل دارید؟ به support@camsbiometrics.com ایمیل بزنید و شماره سریال دستگاه و توضیح کوتاهی از مشکل را بفرستید.
Was this article helpful?