snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ar/developers/extend/capabilities/apis.mdx

@@ -0,0 +1,147 @@
+---
+title: واجهات برمجة التطبيقات
+description: استعلم وعدّل بيانات إدارة علاقات العملاء (CRM) لديك برمجياً باستخدام REST أو GraphQL.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+تم تصميم Twenty ليكون صديقًا للمطورين، حيث يوفر واجهات برمجة قوية تتكيف مع نموذج البيانات المخصص. نحن نوفر أربعة أنواع متميزة من واجهات برمجة التطبيقات لتلبية احتياجات التكامل المختلفة.
+
+## النموذج الأول للمطورين
+
+تقوم Twenty بإنشاء واجهات برمجة التطبيقات خصيصاً لنموذج بياناتك:
+
+* **لا حاجة إلى معرفات طويلة**: استخدم أسماء الكائنات والحقول مباشرة في نقاط النهاية
+* **معالجة متساوية للأشياء القياسية والمخصصة**: تحصل أشياؤك المخصصة على نفس معاملة واجهة برمجة التطبيقات كما هو الحال مع الأشياء المضمنة
+* **نقاط نهاية مخصصة**: يحصل كل كائن وحقل على نقطة نهاية API الخاصة به
+* **وثائق مخصصة**: يتم إنشاؤها خصيصًا لنموذج بيانات مساحة عملك
+
+<Note>
+وثائق واجهة برمجة التطبيقات المخصصة لك متاحة ضمن **الإعدادات → API & Webhooks** بعد إنشاء مفتاح API. نظرًا لأن Twenty تُنشئ واجهات برمجة تطبيقات تتطابق مع نموذج البيانات المخصص لديك، فإن الوثائق فريدة لمساحة عملك.
+</Note>
+
+## نوعا واجهات برمجة التطبيقات
+
+### واجهة برمجة التطبيقات الأساسية
+
+يتم الوصول إليها عبر `/rest/` أو `/graphql/`
+
+تعامَل مع **السجلات** الفعلية لديك (البيانات):
+
+* إنشاء وقراءة وتحديث وحذف الأشخاص والشركات والفرص، إلخ.
+* استعلام وتصفية البيانات
+* إدارة العلاقات بين السجلات
+
+### واجهة برمجة البيانات الوصفية
+
+يتم الوصول إليها عبر `/rest/metadata/` أو `/metadata/`
+
+إدارة **مساحة العمل ونموذج البيانات** لديك:
+
+* إنشاء أو تعديل أو حذف الكائنات والحقول
+* تكوين إعدادات مساحة العمل
+* تعريف العلاقات بين الكائنات
+
+## REST مقابل GraphQL
+
+تتوفر واجهات برمجة التطبيقات الأساسية وواجهات البيانات الوصفية بصيغتي REST وGraphQL:
+
+| التنسيق     | العمليات المتاحة                                                              |
+| ----------- | ----------------------------------------------------------------------------- |
+| **REST**    | CRUD، عمليات الدفعات، إدراج/تحديث                                             |
+| **GraphQL** | نفس الشيء + **عمليات إدراج/تحديث مجمعة**، واستعلامات العلاقات في استدعاء واحد |
+
+اختر بناءً على احتياجاتك — كلا الصيغتين تصلان إلى البيانات نفسها.
+
+## نقاط نهاية API
+
+| البيئة                | عنوان URL الأساسي         |
+| --------------------- | ------------------------- |
+| **السحابة**           | `https://api.twenty.com/` |
+| **الاستضافة الذاتية** | `https://{your-domain}/`  |
+
+## المصادقة
+
+كل طلب API يتطلب تضمين مفتاح API في رأس الطلب:
+
+```
+Authorization: Bearer YOUR_API_KEY
+```
+
+### قم بإنشاء مفتاح API
+
+1. انتقل إلى **الإعدادات → APIs & Webhooks**
+2. انقر على **+ إنشاء مفتاح**
+3. التكوين:
+   * **الاسم**: اسم وصفي للمفتاح
+   * **تاريخ الانتهاء**: متى تنتهي صلاحية المفتاح
+4. انقر على **حفظ**
+5. **انسخه فوراً** — يظهر المفتاح مرة واحدة فقط
+
+<VimeoEmbed videoId="928786722" title="إنشاء مفتاح API" />
+
+<Warning>
+يمنح مفتاح API الخاص بك الوصول إلى بيانات حساسة. لا تشاركه مع خدمات غير موثوقة. إذا تم اختراقه، عطّلْه فوراً وأنشئ مفتاحاً جديداً.
+</Warning>
+
+### تعيين دور لمفتاح API
+
+لتحسين الأمان، عيّن دوراً محدداً لتقييد الوصول:
+
+1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
+2. انقر على الدور الذي ترغب في تعيينه
+3. افتح علامة التبويب **التعيين**
+4. ضمن **مفاتيح API**، انقر على **+ تعيين إلى مفتاح API**
+5. حدد مفتاح API
+
+سيرث المفتاح أذونات ذلك الدور. راجع [الأذونات](/l/ar/user-guide/permissions-access/capabilities/permissions) للحصول على التفاصيل.
+
+### إدارة مفاتيح API
+
+**إعادة التوليد**: الإعدادات → APIs & Webhooks → انقر على المفتاح → **إعادة التوليد**
+
+**حذف**: الإعدادات → APIs & Webhooks → انقر على المفتاح → **حذف**
+
+## ملعب واجهة برمجة التطبيقات
+
+اختبر واجهات برمجة التطبيقات لديك مباشرة في المتصفح باستخدام الملعب المدمج لدينا — متاح لكلٍ من **REST** و**GraphQL**.
+
+### الوصول إلى الملعب
+
+1. انتقل إلى **الإعدادات → APIs & Webhooks**
+2. أنشئ مفتاح API (مطلوب)
+3. انقر على **REST API** أو **GraphQL API** لفتح الملعب
+
+### ما الذي ستحصل عليه
+
+* **وثائق تفاعلية**: يتم إنشاؤها لنموذج البيانات المحدد لديك
+* **اختبارات حيّة**: تنفيذ استدعاءات API فعلية على مساحة عملك
+* **مستكشف المخطط**: تصفح الكائنات والحقول والعلاقات المتاحة
+* **منشئ الطلبات**: أنشئ الاستعلامات مع الإكمال التلقائي
+
+يعكس الملعب الكائنات والحقول المخصصة لديك، لذا تكون الوثائق دائماً دقيقة لمساحة عملك.
+
+## عمليات المجموعة
+
+كلٌ من REST وGraphQL يدعمان عمليات الدفعات:
+
+* **حجم المجموعة**: حتى 60 سجل لكل طلب
+* **العمليات**: إنشاء وتحديث وحذف سجلات متعددة
+
+**ميزات خاصة بـ GraphQL:**
+
+* **إدراج/تحديث دفعي**: إنشاء أو تحديث في استدعاء واحد
+* استخدم الأسماء الجمع للكائنات (على سبيل المثال، `CreateCompanies` بدلاً من `CreateCompany`)
+
+## حدود المعدل
+
+يتم تنظيم طلبات API لضمان استقرار المنصة:
+
+| الحد           | القيمة                 |
+| -------------- | ---------------------- |
+| **الطلبات**    | 100 استدعاء في الدقيقة |
+| **حجم الدفعة** | 60 سجل لكل استدعاء     |
+
+<Tip>
+استخدم عمليات الدفعات لزيادة الإنتاجية — عالج ما يصل إلى 60 سجلًا في استدعاء API واحد بدلاً من إجراء طلبات فردية.
+</Tip>

packages/twenty-docs/l/ar/developers/extend/capabilities/webhooks.mdx

@@ -0,0 +1,112 @@
+---
+title: الويب هوكس
+description: استقبل إشعارات في الوقت الفعلي عند وقوع أحداث في نظام إدارة علاقات العملاء (CRM) الخاص بك.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+تدفع خطافات الويب البيانات إلى أنظمتك في الوقت الفعلي عند وقوع أحداث في Twenty — دون الحاجة إلى الاستطلاع الدوري. استخدمها للحفاظ على تزامن الأنظمة الخارجية، وتشغيل الأتمتة، أو إرسال التنبيهات.
+
+## إنشاء ربط ويب
+
+1. انتقل إلى **الإعدادات → APIs & Webhooks → Webhooks**
+2. انقر على **+ إنشاء ربط ويب**
+3. أدخل عنوان URL لخطاف الويب الخاص بك (يجب أن يكون قابلاً للوصول علنًا)
+4. انقر على **حفظ**
+
+يتم تفعيل خطاف الويب فورًا ويبدأ في إرسال الإشعارات.
+
+<VimeoEmbed videoId="928786708" title="إنشاء خطاف ويب" />
+
+### إدارة Webhooks
+
+**تحرير**: انقر على خطاف الويب → تحديث عنوان URL → **حفظ**
+
+**حذف**: انقر على خطاف الويب → **حذف** → تأكيد
+
+## الأحداث
+
+يرسل Twenty خطافات الويب لأنواع الأحداث التالية:
+
+| حدث             | مثال                                                       |
+| --------------- | ---------------------------------------------------------- |
+| **إنشاء سجل**   | `person.created`, `company.created`, `note.created`        |
+| **تحديث السجل** | `person.updated`, `company.updated`, `opportunity.updated` |
+| **حذف السجل**   | `person.deleted`, `company.deleted`                        |
+
+يتم إرسال جميع أنواع الأحداث إلى عنوان URL لخطاف الويب الخاص بك. قد تتم إضافة تصفية الأحداث في الإصدارات المستقبلية.
+
+## تنسيق الحمولة
+
+يرسل كل خطاف ويب طلب HTTP من نوع POST يتضمن جسمًا بصيغة JSON:
+
+```json
+{
+  "event": "person.created",
+  "data": {
+    "id": "abc12345",
+    "firstName": "Alice",
+    "lastName": "Doe",
+    "email": "alice@example.com",
+    "createdAt": "2025-02-10T15:30:45Z",
+    "createdBy": "user_123"
+  },
+  "timestamp": "2025-02-10T15:30:50Z"
+}
+```
+
+| الحقل           | الوصف                                           |
+| --------------- | ----------------------------------------------- |
+| `حدث`           | ما الذي حدث (على سبيل المثال، `person.created`) |
+| `بيانات`        | السجل الكامل الذي تم إنشاؤه/تحديثه/حذفه         |
+| `الطابع الزمني` | وقت حدوث الحدث (UTC)                            |
+
+<Note>
+استجب بحالة **HTTP 2xx** ‏(200-299) لتأكيد الاستلام. تُسجَّل الاستجابات غير 2xx كإخفاقات في التسليم.
+</Note>
+
+## التحقق من صحة خطاف الويب
+
+يقوم Twenty بتوقيع كل طلب خطاف ويب لأغراض الأمان. تحقّق من التواقيع للتأكد من أن الطلبات أصيلة.
+
+### الرؤوس
+
+| رأس الصفحة                   | الوصف               |
+| ---------------------------- | ------------------- |
+| `X-Twenty-Webhook-Signature` | توقيع HMAC SHA256   |
+| `X-Twenty-Webhook-Timestamp` | الطابع الزمني للطلب |
+
+### خطوات التحقق
+
+1. احصل على الطابع الزمني من `X-Twenty-Webhook-Timestamp`
+2. أنشئ السلسلة: `{timestamp}:{JSON payload}`
+3. احسب HMAC SHA256 باستخدام سر خطاف الويب الخاص بك
+4. قارِن مع `X-Twenty-Webhook-Signature`
+
+### مثال (Node.js)
+
+```javascript
+const crypto = require("crypto");
+
+const timestamp = req.headers["x-twenty-webhook-timestamp"];
+const payload = JSON.stringify(req.body);
+const secret = "your-webhook-secret";
+
+const stringToSign = `${timestamp}:${payload}`;
+const expectedSignature = crypto
+  .createHmac("sha256", secret)
+  .update(stringToSign)
+  .digest("hex");
+
+const isValid = expectedSignature === req.headers["x-twenty-webhook-signature"];
+```
+
+## خطافات الويب مقابل سير العمل
+
+| طريقة                         | الاتجاه | حالة الاستخدام                                              |
+| ----------------------------- | ------- | ----------------------------------------------------------- |
+| **خطافات الويب**              | OUT     | إخطار الأنظمة الخارجية تلقائيًا بأي تغيير في السجل          |
+| **سير العمل + طلب HTTP**      | OUT     | إرسال البيانات إلى الخارج بمنطق مخصص (عوامل تصفية، تحويلات) |
+| **مشغّل خطاف ويب لسير العمل** | IN      | استقبال البيانات في Twenty من الأنظمة الخارجية              |
+
+لاستقبال البيانات الخارجية، راجع [إعداد مشغّل خطاف الويب](/l/ar/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger).