معرفی

Cams Biometric Gateway — Web API 3.0

Cams Biometric Gateway یک Biometric API جامع است که هر دستگاه حضور و غیاب بیومتریک یا کنترل تردد را به برنامه شما متصل می‌کند — ERP، HRMS، حقوق و دستمزد، مدیریت مدرسه، نرم‌افزار سفارشی یا گردش‌کار هوش مصنوعی/اتوماسیون. این سرویس از همه برندهای اصلی دستگاه پشتیبانی می‌کند و صرف‌نظر از سخت‌افزار، یک Biometric API استاندارد مبتنی بر JSON روی HTTP ارائه می‌دهد.

38 عملیات — 11 API از نوع Callback (از دستگاه به سرور) و 27 API از نوع RESTful (از سرور به دستگاه). همه payloadها JSON خام روی HTTP/HTTPS هستند.

همه دستگاه‌های بیومتریک پشتیبانی می‌شوند. دستگاه‌های Cams، دستگاه‌های تأییدشده و برندهای شخص ثالث (ZKTeco، Suprema، Hikvision، Anviz، Morpho/IDEMIA، Virdi، Mantra، Nitgen، Realtime/Startek، Biomax، Secugen، eSSL، Matrix COSEC و غیره). حالت اتصال متناسب با محیط خود را انتخاب کنید.

نحوه کار

Biometric Gateway از اجزای زیر تشکیل شده است:

سرور Gatewayپلتفرم ابری شامل Cams Protocol Engine (ترجمه پروتکل، نرمال‌سازی داده، کش آفلاین، احراز هویت) و لایه API استاندارد که رابطی یکپارچه برای برنامه شما فراهم می‌کند.

Protocol Engineموتور اصلی درون سرور Gateway که با دستگاه‌های بیومتریک ارتباط می‌گیرد، پروتکل‌های اختصاصی هر سازنده را ترجمه می‌کند و ثبت امن تراکنش‌های داده و مدیریت هویت را انجام می‌دهد.

Protocol Engine Liteنسخه درون‌سازمانی که روی سرور خودتان (Windows/Linux) نصب می‌شود، مناسب شبکه‌های فقط LAN یا محیط‌های خودمیزبان. همان API، با استقرار محلی.

یکپارچه با

OdooERPNextSAPMicrosoft Dynamics ZohoBitrix24 OrangeHRMBayZatPalmHRuKnowva FedenaTeachmintEduBricz RazorPayPayruler n8nMakeZapier Claude (MCP)GeminiChatGPT برنامه‌های وب سفارشی

برنامه شما

ERP HRMS Payroll ERP مدارس گردش‌کار هوش مصنوعی (n8n، Zapier) MCP — Claude · Gemini · ChatGPT برنامه‌های سفارشی

↑ API نوع Callback Gateway ← سرور شما (Push)

↓ API نوع RESTful سرور شما ← Gateway (فرمان)

Biometric Gateway

Protocol Engine

پردازش امن احراز هویت ثبت تراکنش‌های داده ترجمه پروتکل کش آفلاین و صف رمزنگاری AES-256 · اعتبارسنجی توکن احراز هویت

لایه API استاندارد

مدیریت هویت یکپارچه‌سازی هوش مصنوعی / MCP توزیع‌کننده Callback مسیریاب فرمان REST نرمال‌سازی داده · پشتیبانی از پروتکل چند برند

اینترنت

اثر انگشت · تشخیص چهره · رگ کف دست · کارت RFID · PIN · QR / بارکد · ردیابی GPS

دستگاه‌های بیومتریک — پشتیبانی از همه برندها

Cams ZKTeco Suprema Hikvision Anviz Morpho / IDEMIA Virdi Mantra Nitgen Realtime Biomax Secugen eSSL Matrix + بسیاری دیگر

نوع API	جهت	تأخیر	کاربرد
API نوع Callback	از دستگاه به سرور شما	بلادرنگ / بدون تأخیر	دریافت ثبت‌های تردد و رویدادهای همگام‌سازی کاربر
API نوع RESTful	از سرور شما به دستگاه	~15 ثانیه	افزودن/حذف کاربر، بارگذاری لاگ‌ها، ثبت‌نام بیومتریک

معرفی

شروع کار

در سه گام یکپارچه کنید. سرور شما برای دریافت callbackها به یک URL قابل دسترس عمومی نیاز دارد.

1

Callback URL خود را پیکربندی کنید

وارد پورتال API Monitor شوید. URL عمومی HTTPS سرور خود را به‌عنوان Callback URL دستگاه(های) خود تنظیم کنید. موتور API رویدادهای بیومتریک را به‌صورت بلادرنگ با POST به این endpoint ارسال می‌کند.

2

دریافت ثبت‌های تردد

endpoint شما یک POST با بدنه JSON خام دریافت می‌کند — برای APIهای Callback نیازی به query parameter نیست. AuthToken را اعتبارسنجی کنید، داده تردد را پردازش کنید و با {"status":"done"} پاسخ دهید.

3

با فراخوانی APIهای RESTful کاربران و دستگاه‌ها را مدیریت کنید

یک فرمان JSON را با POST به URL مربوط به endpoint در RESTful که در حساب API Monitor شما آمده ارسال کنید و stgid (شناسه Service Tag) را به‌عنوان query parameter بدهید. موتور فرمان را در صف قرار می‌دهد و دستگاه ظرف ~15 ثانیه تأیید می‌کند.

قالب Endpoint

نوع API	متد	نحوه ارسال
API نوع Callback (ورودی)	POST	دستگاه به URLی که شما پیکربندی کرده‌اید POST می‌کند. بدنه JSON خام؛ بدون پارامتر.
API نوع RESTful (خروجی)	POST	شما به URL مربوط به endpoint در RESTful (موجود در حساب API Monitor شما) با `?stgid=YOUR_SERVICE_TAG_ID` و بدنه JSON خام POST می‌کنید.

همیشه بلافاصله به درخواست‌های Callback پاسخ دهید. سرور شما باید برای تأیید دریافت، {"status":"done"} (با HTTP 200) برگرداند. پیش از پاسخ، پردازش سنگین انجام ندهید — آن را در صف قرار دهید.

مستندات

مستندات API

مرجع بر اساس موضوع تقسیم شده است. ابتدا از سازگاری دستگاه‌ها شروع کنید، سپس عملیات Callback و REST.

دستگاه‌های پشتیبانی‌شده و حالت‌های اتصالGateway از چه دستگاه‌هایی پشتیبانی می‌کند، هر کدام چگونه متصل می‌شوند (Native Push یا Hybrid Push) و در هر حالت چه عملیات API در دسترس است. مرجع API: معماری، فیلدها و کدهای وضعیتاجزای مشترک همه عملیات: جریان درخواست، فیلدهای JSON مشترک، انواع الگو، کدهای وضعیت، پورت‌ها و رمزنگاری payload. APIهای Callback: رویدادهای بلادرنگ از دستگاه به سرور شماهر رویدادی که دستگاه به callback URL شما می‌فرستد، همراه با JSON دریافتی سرور و پاسخی که باید برگرداند. APIهای RESTful: فرمان‌های سرور شما به دستگاهفرمان‌هایی که سرور شما از طریق Gateway به دستگاه می‌فرستد، همراه با JSON درخواست و پاسخ هر کدام. تست API به‌صورت محلینحوه دریافت callbackهای دستگاه روی رایانه توسعه و تست فرمان‌های REST با Postman پیش از استقرار. نمونه PHP: ذخیره حضور و غیاب بیومتریک در MySQLیک callback handler کارا به زبان PHP که ثبت‌های تردد را در MySQL ذخیره می‌کند، در سه گام. پرامپت‌های تولیدکننده کد با هوش مصنوعییک پرامپت را در دستیار هوش مصنوعی خود کپی کنید تا کد یکپارچه‌سازی برای پشته فناوری شما تولید شود. سؤالات متداول، SDK و هزینهپرسش‌های رایج یکپارچه‌سازان، به‌همراه نحوه عملکرد SDK و قیمت‌گذاری API.

اطلاعات تکمیلی

تماس با ما

برای پشتیبانی API، سازگاری دستگاه یا استعلام فروش:

فروش و پشتیبانی

ایمیلsales@camsbiometrics.com

واتساپ+91-98-409-21006 (پشتیبانی)

فروش+91-98-409-41006

منابع توسعه‌دهندگان

انجمنforum.camsbiometrics.com

دستگاه‌هاdeveloper.camsbiometrics.com

محصولاتcamsbiometrics.com/product

Cams Biometrics (Dheeram Innovations Pvt Ltd) — شماره: 2/98D، طبقه دوم، ساختمان Cams Biometrics، روبه‌روی دانشگاه Satyabama، Semmancheri، OMR، Chennai – 600119، هند.