# أنشئ مفتاح API

> يتيح مفتاح API لرمزك الخاص أو لنظام آخر قراءة متجرك وتحديثه عبر Shoprocket API. أنشئ واحدًا في الإعدادات > مفاتيح API، وامنحه الصلاحيات التي يحتاجها فقط، وانسخ السر، الذي يظهر مرة واحدة.

مركز المساعدة / التكاملات - آخر تحديث 2 نوفمبر 2026

مفتاح API سرّ يتيح لبرنامج أن يعمل على متجرك عبر Shoprocket API. قد يكون ذلك نظام مخزون يحدّث الكميات، أو سكربت يصدّر الطلبات كل ليلة، أو تكاملًا يبنيه لك مطوّر. الـ API مضمّن في كل الخطط.

لكل مفتاح اسمه وصلاحياته، فتمنح كل تكامل ما يحتاجه فقط، وتوقف واحدًا دون المساس بالبقية.

**لا تحتاج إلى مفتاح API لتبيع على موقعك.** تستخدم المضمَّنات المفتاح القابل للنشر لمتجرك (يبدأ بـ `pk_`)، الموجود أصلًا في الرمز الذي تلصقه وعرضه آمن. أما مفتاح API (يبدأ بـ `sk_`) فهو سري ومكانه الخادم فقط.

## قبل أن تبدأ

مفاتيح API جزء من تطبيق **أدوات المطوّرين**، مع **Webhooks**. إن لم ترَ **مفاتيح API** تحت **الإعدادات** في الشريط الجانبي، فانتقل إلى **التطبيقات**، وابحث عن **أدوات المطوّرين** تحت **المطوّرون** وانقر **إضافة**. راجع [أضف التطبيقات وأزلها](https://shoprocket.io/ar/help/the-apps-page.md).

## أنشئ مفتاحًا

1. في لوحة التحكم، انتقل إلى **الإعدادات > مفاتيح API** وانقر **إنشاء مفتاح**.
2. أدخل **الاسم**. سمّه باسم التكامل الذي هو له، مثل "مزامنة المخزون"، لتعرف ما الذي يتعطل إن ألغيته.
3. اختر متى **تنتهي صلاحيته**: **لا تنتهي صلاحيته**، أو بعد 30 أو 90 أو 365 يومًا.
4. حدّد الصلاحيات التي يحتاجها، مجمّعة حسب **المنتجات** و**الطلبات** و**العملاء** و**التسويق** وغيرها. استخدم **تحديد الكل** لمجموعة كاملة، أو **منح وصول كامل** لكل ما يستطيعه المتجر. الأكثر أمانًا أن تمنح المفتاح الصلاحيات التي يحتاجها فقط.
5. انقر **إنشاء مفتاح**.

![لوحة إنشاء مفتاح API: الاسم Inventory sync، وانتهاء الصلاحية بعد 365 يومًا، وصلاحيات المنتجات محدّدة](https://shoprocket.io/img/help/api-keys/create-key.webp)

## انسخ السر الآن

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

هذه هي المرة الوحيدة التي يظهر فيها السر. يخزّنه Shoprocket بصيغة لا يمكن قراءتها مجددًا، فإن فقدته، ألغِ المفتاح وأنشئ واحدًا جديدًا.

![المفتاح المُنشأ للتو، مع سرّه وزر نسخ ولقد حفظته](https://shoprocket.io/img/help/api-keys/copy-secret.webp)

## أدر مفاتيحك

تعرض القائمة كل مفتاح مع نهاية سرّه (مثل `sk_...abc123`)، وصلاحياته، ومن أنشأه، ومتى تنتهي صلاحيته، ومتى استُخدم آخر مرة. المفتاح الذي لم يُستخدم منذ مدة طويلة غالبًا ما يمكنك إلغاؤه.

- **غيّر اسم مفتاح أو صلاحياته**: انقر زر التعديل، وأجرِ تغييراتك وانقر **حفظ**. يبقى السر كما هو.
- **ألغِ مفتاحًا**: انقر **إلغاء** وأكّد. يتوقف عن العمل فورًا، ويتوقف أي تكامل يستخدمه أيضًا. لا يمكن التراجع عن ذلك.

يبقى المفتاح المنتهي أو الملغى في القائمة، بعلامة **منتهي الصلاحية** أو **ملغى**، لترى ما كان عليه.

أبقِ المفاتيح خارج صفحات الويب والتطبيقات ورسائل البريد. أي شخص يملك السر يستطيع فعل كل ما تسمح به صلاحياته. إن ظننت أن مفتاحًا قد تسرّب، فألغه وأنشئ واحدًا جديدًا.

## للمطوّرين

أرسل المفتاح كرمز Bearer. يغطي دليل المطوّرين المفاتيح والصلاحيات، ومرجع API الكامل، وكيفية تجربته في وضع الاختبار. راجع [Authentication](https://shoprocket.io/docs/authentication.md) و[API reference](https://shoprocket.io/docs/api.md).

## ذو صلة

- [Webhooks](https://shoprocket.io/ar/help/webhooks.md)
- [Zapier](https://shoprocket.io/ar/help/zapier.md)
- [ضمّن Shoprocket في أي موقع](https://shoprocket.io/ar/help/embed-on-any-website.md)

[افتح مفاتيح API في لوحة التحكم](https://app.shoprocket.io/go/settings/api-keys)

---

- HTML version: https://shoprocket.io/ar/help/api-keys
- Language: العربية (ar)
- Also in: [Deutsch](https://shoprocket.io/de/hilfe/einen-api-schluessel-erstellen.md), [Ελληνικά](https://shoprocket.io/el/help/api-keys.md), [English](https://shoprocket.io/help/api-keys.md), [Español](https://shoprocket.io/es/ayuda/crear-una-clave-api.md), [Français](https://shoprocket.io/fr/aide/creer-une-cle-api.md), [עברית](https://shoprocket.io/he/help/api-keys.md), [हिन्दी](https://shoprocket.io/hi/help/api-keys.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/kunci-api.md), [Italiano](https://shoprocket.io/it/aiuto/creare-una-chiave-api.md), [日本語](https://shoprocket.io/ja/help/api-keys.md), [Lietuvių](https://shoprocket.io/lt/pagalba/sukurkite-api-rakta.md), [Norsk](https://shoprocket.io/nb/hjelp/opprett-en-api-nokkel.md), [Nederlands](https://shoprocket.io/nl/hulp/api-sleutel-aanmaken.md), [Polski](https://shoprocket.io/pl/pomoc/utworz-klucz-api.md), [Português](https://shoprocket.io/pt/ajuda/criar-uma-chave-de-api.md), [Română](https://shoprocket.io/ro/ajutor/creeaza-o-cheie-api.md), [Русский](https://shoprocket.io/ru/help/api-keys.md), [ไทย](https://shoprocket.io/th/help/api-keys.md), [Türkçe](https://shoprocket.io/tr/yardim/api-anahtarlari.md), [中文](https://shoprocket.io/zh/help/api-keys.md)
