> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# سطح REST API

> نظرة عامة على مستوى عالٍ من خدمات Raydium الأحد عشرة العامة — ما يفعله كل منها، والاتفاقيات المشتركة بينها (غلاف الاستجابة، المصادقة، حدود المعدل، التخزين المؤقت)، وكيفية اختيار الخدمة الصحيحة للتكامل.

<Info>
  **هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.**

  [عرض النسخة الإنجليزية →](/sdk-api/rest-api)
</Info>

<Info>
  **توثيق مستوى النقاط النهائية موجود في علامة التبويب [API Reference](/ar/api-reference).** لكل نقطة نهاية هناك لوحة **جرّب الآن** تفاعلية مدعومة من ملعب OpenAPI في Mintlify — املأ المعاملات في المتصفح واضغط مباشرة على الشبكة الرئيسية (أو devnet، حيث يكون متاحًا). هذه الصفحة هي **رفيق سردي**: ما هي الخدمات الموجودة، متى تستخدم أيًا منها، والاتفاقيات التي تمتد على جميعها. إذا كنت تبحث عن "ما الذي يقبله `GET /pools/info/ids`"، انقر فوق API Reference؛ إذا كنت تبحث عن "أي خدمة يجب أن أدمجها"، فتابع القراءة.
</Info>

## الخدمات الأحد عشرة في لمحة

تشغل Raydium إحدى عشرة خدمة HTTP عامة. يتم توثيق كل منها كمجموعة خاصة بها في علامة التبويب [API Reference](/ar/api-reference) وتحتوي على مواصفات OpenAPI تدعم ملعب التفاعل.

| الخدمة                                                                | مضيف الشبكة الرئيسية           | مضيف Devnet                           | ما تخدمه                                                                                                                                      |
| --------------------------------------------------------------------- | ------------------------------ | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| [API v3](/ar/api-reference/api-v3/overview)                           | `api-v3.raydium.io`            | `api-v3-devnet.raydium.io`            | واجهة برمجية قراءة كنسخة أساسية لمعلومات التجمع / الرمز / الإعداد / معلومات السلسلة. بوابة الوصول الافتراضية للواجهة الأمامية ومعظم المدمجين. |
| [Transaction API](/ar/api-reference/route-api-v2/overview)            | `transaction-v1.raydium.io`    | `transaction-v1-devnet.raydium.io`    | بناء معاملة المبادلة من جانب الخادم.                                                                                                          |
| [Perps API](/ar/api-reference/perp-api-v1/overview)                   | `api-perp-v1.raydium.io`       | —                                     | الإعدادات وبيانات أوصاف الأصول واختيار RPC لواجهة Raydium Perps الأمامية.                                                                     |
| [LaunchLab Mint API](/ar/api-reference/launch-mint-v1/overview)       | `launch-mint-v1.raydium.io`    | `launch-mint-v1-devnet.raydium.io`    | البحث عن الرموز والفهارس والقوائم والبيانات الوصفية لكل رمز.                                                                                  |
| [LaunchLab History API](/ar/api-reference/launch-history-v1/overview) | `launch-history-v1.raydium.io` | `launch-history-v1-devnet.raydium.io` | سجل التداول وتجميعات k-line OHLC لتجمعات LaunchLab.                                                                                           |
| [LaunchLab Forum API](/ar/api-reference/launch-forum-v1/overview)     | `launch-forum-v1.raydium.io`   | `launch-forum-v1-devnet.raydium.io`   | خيوط التعليقات وتحميلات IPFS على عمليات إطلاق LaunchLab. **موقعة بالمحفظة.**                                                                  |
| [LaunchLab Auth API](/ar/api-reference/launch-auth-v1/overview)       | `launch-auth-v1.raydium.io`    | `launch-auth-v1-devnet.raydium.io`    | إصدار `ray-token` JWTs قصيرة الأجل من رسالة موقعة بالمحفظة. مطلوبة من قبل Forum.                                                              |
| [Dynamic IPFS API](/ar/api-reference/dynamic-ipfs-v1/overview)        | `dynamic-ipfs.raydium.io`      | `dynamic-ipfs-devnet.raydium.io`      | إعادة توليد الصور والبيانات الوصفية لـ NFTs الديناميكية (مواضع CLMM، وما إلى ذلك).                                                            |
| [Owner API](/ar/api-reference/owner-api-v1/overview)                  | `owner-v1.raydium.io`          | `owner-v1-devnet.raydium.io`          | مواضع لكل محفظة وأرصدة ومكافآت قابلة للمطالبة.                                                                                                |
| [API v1 (legacy)](/ar/api-reference/api-v1/overview)                  | `api.raydium.io`               | —                                     | مسارات `/v1` و `/v2` القديمة المبقاة حية للعملاء الذين لم ينتقلوا إلى API v3.                                                                 |
| [Temp API](/ar/api-reference/temp-api-v1/overview)                    | `temp-api-v1.raydium.io`       | `temp-api-v1-devnet.raydium.io`       | قلم الانتظار للنقاط النهائية المخصصة قصيرة الأجل. **يمكن تغيير السطح بدون إشعار.**                                                            |

الإصدار يعيش في **اسم المضيف** لخدمات v3 / v1 — لا يوجد إصدار إضافي على مستوى المسار. التغييرات الجذرية يتم شحنها كمضيف جديد مع تداخل؛ التزمت الفريق علنًا بما لا يقل عن 6 أشهر من التداخل على أي ترحيل v3 → v4.

## اختر خدمة

| إذا كنت تريد…                                                               | استخدم                                                         |
| --------------------------------------------------------------------------- | -------------------------------------------------------------- |
| قراءة بيانات التجمع الوصفية والأسعار والعائدات السنوية وإعدادات الرسوم      | **API v3**                                                     |
| قراءة بيانات الرمز الوصفية (الاسم والرمز والشعار والعشرات والعلامات الخطرة) | **API v3** `/mint/list`, `/mint/price`                         |
| بناء معاملة المبادلة / إضافة السيولة / إزالة السيولة من جانب الخادم         | **Transaction API**                                            |
| عرض مواضع محفظة (رموز LP، مواضع CLMM، حصص المزرعة)                          | **Owner API**                                                  |
| البحث عن رموز LaunchLab وتصفح القوائم وجلب البيانات الوصفية لكل رمز         | **LaunchLab Mint API**                                         |
| عرض مخطط k-line / شمعة لتجمع LaunchLab                                      | **LaunchLab History API**                                      |
| نشر أو قراءة التعليقات على عملية إطلاق LaunchLab                            | **LaunchLab Auth API** → `ray-token` → **LaunchLab Forum API** |
| عرض صورة NFT لمواضع CLMM                                                    | **Dynamic IPFS API**                                           |
| عرض إعدادات سوق العقود الآجلة أو قوائم الأصول لواجهة Perps                  | **Perps API**                                                  |
| الحفاظ على التوافق مع عميل بادئة مسار v1/v2                                 | **API v1 (legacy)**                                            |

## الاتفاقيات الشاملة

### غلاف الاستجابة

تعيد كل خدمة ما عدا IPFS نفس غلاف JSON:

```json theme={null}
{
  "id":      "uuid-v4-per-request",
  "success": true,
  "data":    { ... }
}
```

عند الفشل:

```json theme={null}
{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "human-readable error string",
  "data":    null
}
```

تتضمن بعض الخدمات بالإضافة إلى ذلك عددًا صحيحًا `error.code` (يستخدم API v3 هذا لمعرّفات الأخطاء المستقرة عبر الإصدارات الصغيرة). راجع صفحة نظرة عامة على كل خدمة للحصول على الشكل الدقيق.

### المصادقة

يظهر نمطان:

* **بدون مصادقة** — كل خدمة ما عدا Forum. اضربهم بشكل مجهول عبر HTTPS.
* **مصافحة موقعة بالمحفظة** — مطلوبة من قبل **LaunchLab Forum API**. وقّع رسالة Solana ed25519 بالشكل `time:<unix-seconds>` بمحفظتك، وأرسل التوقيع وعنوان المحفظة إلى **LaunchLab Auth API** `/request-token`، واستقبل JWT، وأمرره كرأس طلب `ray-token` على استدعاءات المنتدى اللاحقة.

يقبل ملعب Mintlify `ray-token` في لوحة المصادقة قبل إرسال طلبات المنتدى؛ يتم الاحتفاظ بالقيمة في متصفحك فقط.

### حدود المعدل

تجلس جميع المضيفات خلف Cloudflare مع تحديد معدل تقدمي لكل عنوان IP مصدر. إرشادات منشورة للمدمجين:

الانفجارات فوق الحدود المنشورة ترجع `HTTP 429` مع رأس `Retry-After`. المجمعات أو الروبوتات التي تحتاج إلى حدود أعلى يجب أن تتصل بفريق Raydium بدلاً من ضرب المضيفات العامة — تشغيل الفهرسة الخاصة بك مقابل معرفات البرنامج الموجودة على السلسلة هو أيضًا خيار لأعباء العمل الثقيلة في القراءة.

### التخزين المؤقت والاتساق

* معظم نقاط نهاية قراءة API v3 مخزنة مؤقتًا على الحافة لمدة 5-60 ثانية؛ TTLs محددة موضحة على صفحة API Reference لكل نقطة نهاية.
* يتم إبطال الذاكرة المؤقتة من قبل الفهرس على أحداث برنامج لمس يلاحظها.
* أثناء إعادة الهيكلة الكبيرة أو الازدحام، قد يكون هناك تباعد 1-2 slot بين عرض API وحالة السلسلة. **SDK وقراءات RPC المباشرة دائمًا أكثر حداثة** — إذا كان العميل على وشك توقيع معاملة، أعد جلب الحسابات ذات الصلة عبر RPC، لا تثق بقيمة API بشكل أعمى أبدًا.

### تنسيق الخطأ

تعود الأخطاء كـ HTTP 4xx/5xx مع نفس الغلاف (`success: false`، `msg` مملوء). API v3 بالإضافة إلى ذلك يتضمن `error.code` مستقر:

```json theme={null}
{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "Pool not found",
  "error":   { "code": 40401, "message": "Pool not found" }
}
```

`error.code` مستقر عبر الإصدارات الصغيرة؛ عامله كإشارة أساسية في منطق العميل و `msg` كسطح يمكن قراءته من قبل الإنسان.

### اتفاقية معامل mint-pair

العديد من نقاط نهاية API v3 تقبل `mint1=…&mint2=…` وتتطلب `mint1 < mint2` (ترتيب بايت pubkey تصاعدي). هذا حتى تتمكن API من إرجاع نفس التجمع الأساسي بغض النظر عن ترتيب حجة المتصل المفضل. رتّب الرمزين من جانب العميل قبل بناء URL — تكرر توثيق مستوى النقطة النهاية هذا القيد حيث ينطبق.

## أنماط العميل الموصى بها

1. **ملء مرة واحدة، تحديث بكسل.** اسحب `GET /main/info` و `GET /mint/list` (كلاهما على API v3) في تحميل التطبيق وخزّن مؤقتًا محليًا مع TTL بساعة واحدة. كلاهما مخزن مؤقت بشكل كبير على الحافة ونادرًا ما يتغير.
2. **الكميات حيث تسمح النقطة النهاية.** `GET /pools/info/ids?ids=…` يقبل قائمة مفصولة بفواصل — اجلب عشرة تجمعات في طلب واحد، وليس عشرة طلبات.
3. **تجنب عمليات جلب السعر على المسار الساخن.** `GET /mint/price` جيد لعرض الواجهة؛ لا تحلقها أبدًا في بوت. للروبوتات التجارية، قم بتشغيل الفهرس أو اشترك في أحداث `programSubscribe` RPC مباشرة.
4. **المرآة أو الوكيل لإنتاجية عالية.** أي شيء فوق سقف حد المعدل المنشور يجب أن يتم تقديمه من طبقة الذاكرة المؤقتة الخاصة بك، وليس مباشرة من المضيفات العامة. المجمعات ذات `>120 req/min` المستمرة ضد `transaction-v1` يجب أن تشغل محرك الاقتباس / الأسار الخاص بها.
5. **أعد الجلب قبل التوقيع مباشرة.** استجابات API يمكن أن تكون قديمة 5-60 ثانية. للحصول على لقطة تجمع صحيحة فعلاً في وقت التوقيع، أعد قراءة الحسابات ذات الصلة عبر SDK أو اتصال RPC مباشر `getMultipleAccounts`. تعامل مع قيم API كتلميح بحث، وليس كمصدر تسوية.
6. **استخدم Transaction API للتكامل منخفض الاحتكاك.** إذا كنت لا تريد تجميع SDK في عميلك (أصلي محمول، بوت في بيئة مقيدة)، فسيعود Transaction API معاملة موضوعة بـ base64 الإصدار للمستخدم للتوقيع عليها. `swapResponse` الذي يعيده يضمن عرضًا — تعامل معه كصالح لحوالي 30 ثانية.

## أين تذهب بعد ذلك

* **مرجع النقطة النهاية (تفاعلي)** — [API Reference](/ar/api-reference). كل خدمة لها مجموعتها الخاصة؛ انقر فوق أي نقطة نهاية للمعاملات وشكل الاستجابة وعينات الكود ولوحة جرّب الآن.
* **TypeScript SDK** — [`sdk-api/typescript-sdk`](/ar/sdk-api/typescript-sdk). يستهلك SDK API v3 داخليًا لعدة مسارات؛ لبناء المعاملات يعيد جلب الحالة من RPC دائمًا، لا يثق بـ API بشكل أعمى.
* **تكامل Trade API** — [`integration-guides/aggregator`](/ar/integration-guides/aggregator). أنماط لربط سيولة Raydium في مجمع متعدد DEX.
* **الوثائق الملائمة للذكاء الاصطناعي** — [`sdk-api/ai-integration`](/ar/sdk-api/ai-integration). مؤشرات لعملاء الكود بالذكاء الاصطناعي الذين يحتاجون إلى استدعاء هذه الواجهات البرمجية.