> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# 6MM Agent SDK

> استخدم 6MM Agent SDK لتنفيذ استدعاءات API موقّعة من خدمات Java وPHP الخلفية، وربط المستخدمين، وتحويل الأصول، وإنشاء روابط الدخول إلى التداول، وضمان عدم تكرار المعالجة، والتحقق من Webhook.

6MM Agent SDK مخصص لخدمات الخلفية الشريكة التي تحتاج إلى استدعاء API الوكيل المميز دون تنفيذ معالجة التوقيع والطلبات من الصفر. يجب ألا تعمل في كود المتصفح أو الهاتف المحمول أو سطح المكتب العام لأن التكامل يستخدم سريا API الشريك.

<h2 id="when-to-use-the-agent-sdk">
  متى تستخدم Agent SDK
</h2>

استخدم Agent SDK عندما يحتاج نظامك الخلفي إلى ربط مستخدم تابع للشريك، أو نقل الأصول عبر سير عمل معتمد، أو الاستعلام عن سجلات التداول، أو إنشاء عنوان URL للدخول إلى التداول المضمّن، أو التحقق من إشعارات Webhook. استخدم [Trading Widget SDK](/ar/sdk/trading-widget/overview) بشكل منفصل عندما تحتاج الواجهة الأمامية للشريك إلى عرض واجهة التداول.

<h2 id="capabilities">
  القدرات
</h2>

| السيناريو          | Java SDK | PHP SDK |
| ------------------ | -------- | ------- |
| مستخدم الربط       | مدعوم    | مدعوم   |
| تحويل مبلغ ثابت    | مدعوم    | مدعوم   |
| انقل كل شيء        | مدعوم    | مدعوم   |
| النقل العكسي       | مدعوم    | مدعوم   |
| ترتيبات الاستعلام  | مدعوم    | مدعوم   |
| إنشاء URL          | مدعوم    | مدعوم   |
| التحقق عبر Webhook | مدعوم    | مدعوم   |

<h2 id="common-configuration">
  التكوين المشترك
</h2>

| مفتاح           | مثال                                                                               | الوصف                                      |
| --------------- | ---------------------------------------------------------------------------------- | ------------------------------------------ |
| baseUrl         | `https://agent-api.6mm.com`                                                        | 6MM API خدمة URL دون تتبع أو شرط.          |
| agentCode       | AGENT001                                                                           | رمز وكيل الشريك.                           |
| apiSecret       | سر واجهة المستخدم الخاص بك                                                         | API التوقيع السري المخزن فقط في الخلفية.   |
| defaultCurrency | USDT                                                                               | العملة الافتراضية للتحويل وحساب API.       |
| webhookUrl      | [https://partner.example.com/6mm/webhook](https://partner.example.com/6mm/webhook) | نقطة نهاية الشريك لإشعارات الويب هوك 6MM . |

<h2 id="typical-integration-flow">
  تدفق التكامل النموذجي
</h2>

1. تقوم واجهة الشريك بالتحقق من صحة المستخدم من خلال نظام حسابات الشريك الخاص.
2. يقوم الطرف الخلفي للشريك بتعيين المستخدم إلى معرف مستقر من جانب الشريك.
3. الواجهة الخلفية تتصل ب Agent SDK مع `agentCode` و API السر المحمي.
4. يوقع SDK ويرسل العميل API الطلب.
5. يخزّن النظام الخلفي معرّف العملية المُعاد، ثم يعالج إشعارات Webhook اللاحقة بصورة تضمن عدم تكرار المعالجة.
6. تحصل الواجهة الأمامية فقط على النتيجة القصيرة أو بطاقة الدخول التي تحتاجها.

<h2 id="choose-an-sdk">
  اختر SDK
</h2>

| مكدس الخلفية | ابدأ من هنا                                                                                                        |
| ------------ | ------------------------------------------------------------------------------------------------------------------ |
| Java         | [نظرة عامة Java SDK](/ar/sdk/agent-sdk/java/overview) و [Java البداية السريعة](/ar/sdk/agent-sdk/java/quick-start) |
| PHP          | [نظرة عامة PHP SDK](/ar/sdk/agent-sdk/php/overview) و [PHP البداية السريعة](/ar/sdk/agent-sdk/php/quick-start)     |

<h2 id="production-checklist">
  قائمة تحقق الإنتاج
</h2>

* تحميل `apiSecret` من مدير سري خلفي، وليس من الشيفرة المصدرية.
* إبقاء الاعتماد على التطوير والإخراج والإنتاج.
* استخدام خريطة مستخدم الشريك المستقرة ومعرفات أوامر الأعمال الفريدة.
* الحفاظ على المعرف الأصلي عند التحقق من حالة طلب انتهاء الوقت.
* التحقق من توقيعات webhook وتخزين معرفات الأحداث المعالجة.
* حذف الأسرار والتواقيع من السجلات مع الاحتفاظ بمعرفات الطلبات للدعم.

<h2 id="next-steps">
  الخطوات التالية
</h2>

#### [Java البداية السريعة](/ar/sdk/agent-sdk/java/quick-start)

قم بتثبيت وتهيئة Agent SDK في خلفية Java .

#### [PHP البداية السريعة](/ar/sdk/agent-sdk/php/quick-start)

قم بتثبيت وتهيئة Agent SDK في خلفية PHP .

#### [ويبهوكس وإيديمونتسي](/ar/sdk/security/webhooks-idempotency)

تحقق من المكالمات المتكررة ومنع معالجة الأعمال المكررة.