المطورون

طلب واحد، مسار واحد، إشعار webhook واحد.

أنشئوا عملية تحقق عبر الواجهة البرمجية، ووجّهوا عميلكم إلى المسار المستضاف، واستلموا القرار على خادمكم. تعمل البيئة التجريبية بهويات اصطناعية، فتُنجزون الدمج دون أي بيانات حقيقية.

الوصول بدعوة: إن لم يكن لديك حساب، اطلب مساحتك في بيئة الاختبار.

طلباً في الثانية لكل مفتاح، للقراءة وللكتابة
20 / 10
من إعادة المحاولة لكل إشعار ويب، مع إمكانية إعادة إرساله من منصة الإدارة
24 h
مدة صلاحية مفتاح عدم التكرار
24 h
إصدار واجهة البرمجة، في الترويسة Atlas-Version
2026-10-01

البدء السريع

ابدأوا في ثلاث خطوات

1

إنشاء عملية التحقق

باستخدام مفتاح sandbox تُنشئونه من لوحة التحكم. يتضمن الرد رابط المسار الخاص بعميلكم.

الطلب

curl -X POST https://verify.atlasidv.com/v1/verifications \
  -H "Authorization: Bearer atlas_sk_sandbox_…" \
  -d '{
    "template": "onboarding_bank",
    "document_types": ["id_card", "passport"],
    "applicant": { "reference": "client-4821" }
  }'

الرد 202 Accepted

{
  "id": "7f3c9a2e-…",
  "status": "created",
  "flow": {
    "url": "https://flow.atlasidv.com/…"
  }
}
2

توجيه عميلكم إلى المسار

إعادة توجيه من تطبيقكم، أو رابط عبر رسالة نصية أو بريد إلكتروني، أو رمز QR يُمسح ضوئيًا في الوكالة. يتبع المسار لغة الهاتف (الفرنسية، الإنجليزية، العربية) ويعتمد ألوان علامتكم.

مسار عميلكم

  1. 1موافقة موثّقة بالتاريخ والوقت
  2. 2اختيار البلد ونوع الوثيقة
  3. 3تصوير الوثيقة من الوجه والظهر
  4. 4صورة سيلفي
  5. 5الإرسال، ثم شاشة ختامية تحمل علامتكم التجارية
3

استلام القرار

يصلكم إشعار webhook موقّع عند كل مرحلة مهمة. تحققوا من التوقيع، ثم اطّلعوا على تفاصيل الفحوصات عبر GET /v1/verifications/{id}.

إشعار webhook المستلَم

{
  "event": "verification.completed",
  "verification": {
    "id": "7f3c9a2e-…",
    "status": "approved",
    "decision": "approved",
    "reason_codes": [],
    "template": "onboarding_bank"
  },
  "sent_at": "2026-10-03T09:41:12Z"
}

التحقق من التوقيع (Node.js)

import crypto from 'node:crypto';

const signed = `${headers['x-atlas-timestamp']}.${rawBody}`;
const expected = 'v1=' + crypto
  .createHmac('sha256', webhookSecret)
  .update(signed)
  .digest('hex');
const received = headers['x-atlas-signature'] ?? '';
const ok = received.length === expected.length &&
  crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));

المرجع

ما تغطيه الواجهة البرمجية

مصادقة بمفتاح API (Bearer)، بمفتاح لكل بيئة، مع صلاحيات القراءة أو الكتابة أو المراجعة.

  • عمليات التحقق

    /v1/verifications

    إنشاء عمليات التحقق وتتبعها، والاطلاع على كل فحص مع درجته وحالته وتفسيره، وتنزيل تقرير PDF بالفرنسية أو العربية.

  • ملفات المراجعة

    /v1/cases

    قائمة المراجعة: إسناد الملفات، والبت في تطابق مع إحدى القوائم، واتخاذ القرار، والموافقة وفق مبدأ التحقق المزدوج.

  • المستخدمون

    /v1/users

    عملاؤكم بحسب مرجعهم: السجل، والحالة (نشط، مُبلَّغ عنه، محظور)، وصور الوجه المرجعية، والحذف.

  • المستندات

    /v1/documents

    Atlas Read: إرسال مستند، وتحديد نوعه والحقول المطلوبة، والاطلاع على الحقول المستخرجة مع درجة الثقة في كل منها.

  • إشعارات Webhook

    verification.*

    ملف بحاجة إلى مراجعة، أو عملية تحقق مكتملة أو فاشلة، أو مستخدم معدَّل. محتوى موقّع باستخدام HMAC SHA-256، مع إعادة المحاولة عند الإخفاق.

  • البيئات

    atlas_sk_sandbox_ / atlas_sk_prod_

    بيئتا sandbox والإنتاج منفصلتان: المفاتيح وإشعارات webhook والبيانات. وتدلّكم بادئة المفتاح على البيئة التي تعملون فيها.

الأدوات

الأدوات: أين وصلنا

ما يمكنكم استخدامه اليوم، وما نعمل على تجهيزه.

  • متاح

    واجهة REST ومواصفات OpenAPI

    تُنزَّل المواصفات من لوحة التحكم.

  • متاح

    المسار المستضاف (ويب الهاتف المحمول)

    الفرنسية والإنجليزية والعربية؛ شعاركم وألوانكم؛ الكاميرا أو تحميل ملف.

  • متاح

    إشعارات webhook موقّعة

    كل محاولة إرسال ظاهرة في لوحة التحكم.

  • متاح

    البيئة التجريبية (sandbox)

    هويات اصطناعية جاهزة: لا تُقبل فيها أي وثيقة حقيقية.

  • متاح

    مجموعة Postman

    متاحة اليوم لمنتج Atlas Read، وقريبًا لمنتج Atlas ID.

  • قريباً

    حزمة SDK للهاتف المحمول (iOS و Android)

    مع قراءة شريحة NFC في الوثائق المزوّدة بها.

  • قريباً

    توثيق عام على الإنترنت

    في الأثناء، يتوفر التوثيق في لوحة التحكم، ونرافقكم طوال مرحلة الدمج.

بيئة الاختبار

أول عملية تحقق لكم في البيئة التجريبية.

سجّلوا الدخول إلى لوحة التحكم، وأنشئوا مفتاح sandbox، ونفّذوا الطلب أعلاه. ليس لديكم حساب بعد؟ اطلبوا مساحتكم: ننشئ مؤسستكم ونرسل إليكم الدعوة.