# مفاتيح API

> لكل متجر مفتاحان. الأول عام ومكانه صفحاتك، والثاني سري ومكانه خادمك.

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

## المفتاحان

تجدهما في صفحة [مفاتيح API](https://dashboard.antiro.io/dashboard/api-keys) في لوحة التحكم.

|  | المفتاح العام | المفتاح السري |
| --- | --- | --- |
| يبدأ بـ | `pk_` | `bf_` |
| يستعمله | السكربت في المتصفح | الواجهة في الخادم |
| مكانه | صفحاتك، في `data-key` | خادمك، في `X-API-Key` |
| يراه الزوار | نعم، ولا خطر في ذلك | أبداً |

**أين يوضع كل مفتاح**

```bash
# in the page: public
data-key="pk_xxxxx"

# on your server only: .env
ANTIRO_SECRET_KEY=bf_xxxxx
```

> **أبقِ المفتاح السري في خادمك**
>
> لا تضعه في أي صفحة، ولا في أي ملف JavaScript يصل إلى المتصفح. من يملكه يستطيع إرسال الطلبات إلى Antiro باسم متجرك.

## الدومينات المسموحة

يعمل المفتاح العام على دومين متجرك ونطاقاته الفرعية، وتعرض صفحة مفاتيح API الدومينات المسموحة لكل متجر.

ومن أي دومين آخر يرفض Antiro طلبات السكربت. تبقى الصفحة تعمل، لكنها تصبح بلا حماية.

## استبدال المفتاح

**المفتاح السري.** يظهر مرة واحدة عند إنشائه، وإنشاء مفتاح جديد هو الطريقة الوحيدة لرؤية مفتاح سري مرة أخرى. يتوقف القديم خلال دقيقة، فحدّث خادمك فوراً.

**المفتاح العام.** إنشاء مفتاح جديد يستبدل القديم، فحدّث `data-key` في صفحاتك.