جلسات الالتقاط

{
  "id": "cap_01m...",
  "object": "capture_session",
  "identity_id": "idn_01m...",
  "status": "open",
  "nonce": "...",
  "expires_at": "2026-10-30T10:03:00Z",
  "capture_token": "cap_01m....secret",
  "upload_url": "https://api.warka-iq.com/v1/capture-sessions/cap_01m.../frames",
  "policy": {
    "min_frames": 1,
    "max_frames": 5,
    "max_bytes_per_frame": 8388608,
    "formats": ["image/jpeg", "image/png"],
    "challenge": null
  }
}

رفع الإطارات

أرسل Authorization: Capture <capture_token> مع إطار واحد بصيغة multipart. تتحقق وركاء من الملف وتزيل بياناته الوصفية وتشفره وتخزنه. ونجاح الرفع لا يثبت شيئاً عن الكاميرا ولا يسجل حضوراً.

تدوم الجلسات نحو ثلاث دقائق. ويمكن إرفاق تفاصيل العميل مثل طراز الجهاز عند إنشاء الجلسة، وتعدها وركاء غير موثقة.

ينفق إنشاء الجلسة المحاولة حتى لو لم يُرفع أي إطار. راجع الحصص وحدود المعدل.

تطبيقات الويب

لا يستطيع المتصفح استدعاء upload_url، لأن مسار الإطارات لا يقبل الطلبات من أصل مختلف. في تطبيق الويب أرسل الإطارات إلى نظامك الخلفي، ثم يرسلها نظامك إلى التحقق باسم frames في طلب multipart نفسه مع capture_session_id. أما التطبيقات الأصلية فترفع مباشرة برمز الالتقاط.