خانه / محصولات / APIها / API حضور و غیاب HTTP

API

API حضور و غیاب HTTP

Q: HTTP Attendance API چه کاری انجام میدهد؟

درگاه مستقل از دستگاه است که ترددهای تشخیصدادهشده حضور و غیاب، heartbeatها و بررسیهای اشتراک را میپذیرد، آنها را با شماره سریال و توکن دستگاه احراز هویت میکند و به خط لوله مشترک حضور و غیاب Cams میفرستد.

Q: آیا حضور و غیاب از طریق HTTP مانند دستگاهها با آن رفتار میشود؟

بله. ترددها به همان خط لولهای که موتورهای بومی HTTP، TCP و MQTT استفاده میکنند هدایت میشوند، بنابراین ذخیرهسازی و ارسال پاییندست فارغ از نوع انتقال یکسان است.

ورودی واحد HTTPS برای هر کلاینتی که حضور و غیاب تولید می‌کند. HTTP Attendance API با شماره سریال دستگاه و توکن احراز هویت می‌کند، سپس هر تردد تشخیص‌داده‌شده را به همان خط لوله ذخیره‌سازی و ارسال به مشتری که هر موتور بومی Cams استفاده می‌کند هدایت می‌کند.

شروع کنید مستندات توسعه‌دهندگان

نمای کلی

یک درگاه HTTPS مستقل از دستگاه برای دریافت تردد حضور و غیاب، heartbeat و بررسی اشتراک از هر کلاینت.

HTTP Attendance API درگاه مستقل از دستگاه روی مسیر /api/attendance/v1/{op} است. هر درخواست را با هدرهای شماره سریال دستگاه (sn) و auth-token احراز هویت می‌کند، سپس دریافت می‌کند. punch (یک رویداد حضور و غیاب تشخیص‌داده‌شده)، heartbeat (حضور دستگاه)، validity (بررسی اشتراک) و config را ارائه می‌دهد. ترددها به خط لوله مشترک هدایت می‌شوند و ذخیره‌سازی و ارسال پایین‌دست به سرور مشتری مانند انتقال‌های بومی HTTP، TCP و MQTT یکسان است — بنابراین فارغ از نحوه رسیدن حضور و غیاب، یکپارچه‌سازی‌ها یکدست می‌مانند.

APIRESTHTTPSJSONC++

کاربرد در:مدارس، دانشگاه‌ها و پردیس

POST /api/attendance/v1/punch

curl https://api.camsbiometrics.com/api/attendance/v1/punch \
  -H "sn: SN7A2300583" -H "auth-token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "user_id":"1001", "att_time":"2026-06-21 09:30:00",
        "att_state":1, "input_type":50 }'
# -> 200 {"ok":true}

قابلیت‌ها

چه کاری انجام می‌دهد

دریافت یک تردد

یک رویداد حضور و غیاب تشخیص‌داده‌شده را با کاربر، زمان‌مهر، وضعیت ورود/خروج، نوع ورودی و مکان اختیاری با POST ارسال کنید.

گزارش حضور دستگاه

یک heartbeat بفرستید تا دستگاه بدون هیچ بدنه‌ای آنلاین علامت بخورد.

بررسی اعتبار

پیش از ارسال داده بپرسید که آیا اشتراک حضور و غیاب دستگاه فعال است.

خط لوله یکپارچه

هر تردد در همان مسیر ذخیره‌سازی و ارسال دریافت بومی TCP و MQTT قرار می‌گیرد.

امکانات

همه‌چیز در بسته

ورودی واحد HTTPS برای کلاینت‌های لبه، اپ، وب و ترکیبی روی /api/attendance/v1/{op}
احراز هویت مبتنی بر هدر: شماره سریال دستگاه (sn) به‌علاوه auth-token، با کنترل اشتراک
endpoint punch یک رویداد حضور و غیاب تشخیص‌داده‌شده (کاربر، زمان، ورود/خروج، نوع ورودی، موقعیت جغرافیایی اختیاری) را دریافت می‌کند
endpoint heartbeat دستگاه را برای ردیابی حضور آنلاین علامت می‌زند
endpoint validity پیش از ارسال داده توسط کلاینت، وضعیت زنده اشتراک را برمی‌گرداند
خط لوله مشترک: ذخیره‌سازی و ارسال به سرور مشتری یکسان با موتورهای بومی
قرارداد خطای JSON یکدست برای شماره سریال مفقود، دستگاه ناشناخته، توکن نامعتبر یا اشتراک غیرفعال
پشت nginx با سقف اندازه بدنه و محدودسازی نرخ

با HTTP Attendance API بسازید

یک کلید بگیرید، مستندات را بخوانید و عرضه کنید. تیم ما در اولین یکپارچه‌سازی شما کمک می‌کند.

گفتگو با یک مهندس WhatsApp

پرسش‌های متداول

HTTP Attendance API چه کاری انجام می‌دهد؟

درگاه مستقل از دستگاه است که ترددهای تشخیص‌داده‌شده حضور و غیاب، heartbeatها و بررسی‌های اشتراک را می‌پذیرد، آن‌ها را با شماره سریال و توکن دستگاه احراز هویت می‌کند و به خط لوله مشترک حضور و غیاب Cams می‌فرستد.

درخواست‌ها چگونه احراز هویت می‌شوند؟

هر درخواست یک هدر شماره سریال دستگاه (sn) و یک هدر auth-token دارد؛ هر دو باید معتبر باشند. endpointهای بیومتریک علاوه بر آن به اشتراک فعال حضور و غیاب نیاز دارند.

آیا حضور و غیاب از طریق HTTP مانند دستگاه‌ها با آن رفتار می‌شود؟

بله. ترددها به همان خط لوله‌ای که موتورهای بومی HTTP، TCP و MQTT استفاده می‌کنند هدایت می‌شوند، بنابراین ذخیره‌سازی و ارسال پایین‌دست فارغ از نوع انتقال یکسان است.