یک قرارداد برای همه دستگاهها. 38 عملیات در پنج گروه قابلیت، در دسترس بهصورت فراخوانیهای همگام REST و webhookهای بلادرنگ Callback.
همه فراخوانیهای REST به یک میزبان نسخهبندیشده ارسال میشوند.
https://api.camsbiometrics.com/v3/
هر درخواست یک AuthToken همراه دارد که به حساب و دستگاه شما محدود است. کلیدها از پورتال توسعهدهندگان صادر میشوند.
درخواستها بهصورت form-encoded یا JSON. پاسخها JSON با فیلدها و کدهای خطای قابل پیشبینی هستند.
دو روش یکپارچهسازی
شما گیتوی را فرامیخوانید و بلافاصله پاسخ میگیرید. ایدهآل برای دریافت حضور و غیاب، فهرست کردن کاربران، ثبتنام یک نفر یا باز کردن درب بنا به درخواست.
یک URL ثبت کنید و گیتوی رویدادها را در همان لحظه که دستگاه گزارش میدهد برای شما ارسال میکند — بدون polling و با تلاش مجدد خودکار هنگام خطا.
عملیات
گروهبندی بر اساس کارکرد. نامها دقیقاً با endpointهای گیتوی متناظرند.
همه ترددها در یک بازه تاریخی در سطح حساب.
لاگهای یک کد کارمندی در یک دوره.
ترددهای ثبتشده توسط دستگاهی با یک شماره سریال.
خلاصه روزانه بهازای هر کارمند (ورود/خروج، ساعت کار).
جفت اولین ورود / آخرین خروج برای هر کارمند در هر روز.
تصویر لحظهای ترددهای امروز.
عکسهای ثبتشده همراه یک تردد، در صورت پشتیبانی.
خروجی گروهی برای حقوق و دستمزد و تطبیق.
ایجاد کاربر روی یک یا چند دستگاه.
ویرایش نام، نقش، اعتبار یا سطح دسترسی.
حذف یک کاربر از دستگاه.
جستجوی کاربر با کد، همراه با اطلاعات احراز هویت اختیاری.
فهرست همه افراد ثبتنامشده روی یک دستگاه.
نمایش اینکه کاربر روی کدام دستگاهها وجود دارد.
ارسال الگوی اثر انگشت به دستگاه.
ثبت الگوی چهره در صورت پشتیبانی.
اختصاص کارت RFID / مجاورتی به یک کاربر.
تنظیم یا تغییر PIN / گذرواژه دستگاه.
همسانسازی کاربران و الگوها بین دستگاهها.
ارسال دوباره اطلاعات کاربر به صف دستگاه.
فعالسازی رله در، گیت گردان، گیت بالابر، گیت لولایی یا راهبند بازویی بهصورت بلادرنگ.
قفل کردن / نگه داشتن یک در تحت کنترل شما.
خواندن وضعیت فعلی باز / بسته.
تعریف بازههای دسترسی زمانمحور.
لاگ رویدادهای ورود / خروج و در.
فهرست همه دستگاههای متصل.
مدل، فریمور، ظرفیت و شمارندهها.
وضعیت آنلاین، آخرین اتصال و عمق صف.
تأیید دسترسپذیری یک دستگاه در همین لحظه.
هماهنگسازی ساعت دستگاه با سرور.
راهاندازی مجدد دستگاه از راه دور.
پاک کردن دستورهای گیرکرده از صف.
پیگیری وضعیت یک دستور صفشده.
اشتراک یک URL وبهوک برای رویدادهای زنده.
در هر تردد و بهصورت بلادرنگ فعال میشود.
تغییر وضعیت آنلاین / آفلاین و سلامت.
تأیید رسیدن یک الگو به دستگاه.
پیگیری پیشرفت مهاجرت گروهی دستگاه / داده.
پاسخهای قابل پیشبینی
| کد | معنا | چه باید کرد |
|---|---|---|
200 | موفق | payload JSON را پردازش کنید. |
401 | AuthToken نامعتبر یا ناموجود | کلید API و جفتسازی دستگاه را بررسی کنید. |
404 | دستگاه یا کاربر یافت نشد | شماره سریال / کد کارمندی را بررسی کنید. |
409 | دستگاه آفلاین / در صف | دستور در صف است؛ GetCommandStatus را poll کنید. |
429 | محدودیت نرخ | کمی صبر کنید و با jitter دوباره تلاش کنید. |
شروع سریع شما را در چند دقیقه از کلید API به اولین لاگ حضور و غیاب میرساند.
ما از کوکیها برای سنجش بازدید و بهبود BiometricAPI.com استفاده میکنیم. تحلیلها تا زمانی که نپذیرید غیرفعال میمانند. بیشتر بدانید.