# البداية السريعة

> اربط متجراً بكود خاص في أربع خطوات. تحتاج إلى حساب Antiro وإلى إمكانية تعديل صفحات متجرك وكود خادمك.

هذه صفحة واحدة من توثيق Antiro (https://docs.antiro.io/ar/quickstart). كل الصفحات في ملف واحد: https://docs.antiro.io/ar/llms-full.txt

## خذ مفتاحيك

افتح [مفاتيح API](https://dashboard.antiro.io/dashboard/api-keys) في لوحة التحكم. يستعمل متجرك مفتاحين، وإن نقص أحدهما فأنشئه من هناك:

-   **المفتاح العام** (`pk_…`) مكانه صفحاتك.
-   **المفتاح السري** (`bf_…`) مكانه خادمك. يظهر مرة واحدة فقط، فاحفظه عند إنشائه.

## ضع السكربت

الصق هذا السطر في كل صفحة فيها نموذج طلب، وضع مفتاحك العام مكان `pk_xxxxx`. يجد السكربت النموذج وحده، ويفحص الطلب عند ضغط الزبون على زر الطلب.

**صفحة الطلب عندك**

```html
<script
  src="https://js.antiro.io/v2/antiro.js"
  data-key="pk_xxxxx"
  async></script>
```

## افحص الطلب في خادمك

يضيف السكربت إلى النموذج حقلاً مخفياً اسمه `antiro_token`. قبل قبول أي طلب، أرسله إلى Antiro مع قيمة هذا الحقل.

**خادمك**

```bash
curl https://api.antiro.io/v1/assessments \
  -H "X-API-Key: $ANTIRO_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_token": "<antiro_token>",
    "order_id": "1042",
    "phone": "0661234567"
  }'
```

## نفّذ القرار

يخبرك الحقل `action` في الجواب بما تفعله:

| `action` | ما تفعله |
| --- | --- |
| `allow` | اقبل الطلب. |
| `review` | أوقف الطلب حتى يراجعه فريقك. |
| `block` | ارفض الطلب. |

> **لا تتخطَّ الفحص في الخادم**
>
> يستطيع البوت إرسال الطلب إلى خادمك مباشرة دون فتح صفحتك أصلاً، والفحص في الخادم هو ما يغلق هذا الباب.

> **راقب قبل أن تفعّل**
>
> أثناء التجربة، اجعل المتجر في وضع **المراقبة** من صفحة [الحماية](https://dashboard.antiro.io/dashboard/protection). يبقى `action` على `allow`، ويبيّن `recommended` ما كان Antiro سيفعله.

## الخطوات التالية

- [نماذج الطلب](https://docs.antiro.io/ar/sdk/order-forms): علّم النماذج والأزرار التي لا يتعرف عليها السكربت.
- [فحص الطلب](https://docs.antiro.io/ar/api/assessments): أرسل كل حقل يستفيد منه Antiro، ليكون القرار أدق.
- [تنفيذ القرار](https://docs.antiro.io/ar/api/decisions): تعامل مع كل جواب، وحتى مع غياب الجواب.
- [إبلاغ النتيجة](https://docs.antiro.io/ar/api/outcomes): أخبر Antiro بما وجده فريقك.