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

# نظرة عامة على واجهة برمجة تطبيقات Ayrshare

> واجهات برمجة تطبيقات اجتماعية قوية تتيح لك إرسال منشورات وسائل التواصل الاجتماعي والحصول على التحليلات بسهولة. للمطورين والشركات من جميع الأحجام.

توفّر واجهة REST API لوسائل التواصل الاجتماعي للمطورين وصولًا برمجيًا إلى شبكات تواصل اجتماعي متعددة من خلال واجهة موحّدة واحدة.
من خلال واجهة API الاجتماعية الخاصة بـ Ayrshare، يمكنك إدارة أنشطة وسائل التواصل الاجتماعي بما في ذلك إنشاء المنشورات وحذفها واسترجاع التحليلات والتفاعل مع التعليقات والمراجعات وإدارة الرسائل المباشرة وإنشاء إعلانات Facebook وأداء إجراءات أخرى لوسائل التواصل الاجتماعي عبر المنصات.

تدعم واجهة API حاليًا 13 شبكة تواصل اجتماعي رئيسية: Bluesky وFacebook وGoogle Business Profile وInstagram وLinkedIn وPinterest وReddit وSnapchat وTelegram وThreads وTikTok وX (المعروفة سابقًا بـ Twitter) وYouTube.
من خلال التكامل مع واجهة API هذه، يمكن للمطورين أتمتة مهام إدارة وسائل التواصل الاجتماعي عبر كل هذه المنصات في وقت واحد.

بيانات طلب واستجابة استدعاءات API بصيغة JSON، مما يسمح بالتحليل والمعالجة بسهولة في معظم لغات البرمجة.

إذا كنت مشتركًا في خطة Launch أو Business أو Enterprise، فراجع [نظرة عامة على خطة Business](/multiple-users/business-plan-overview) و[نظرة عامة على خطة Launch](/multiple-users/business-launch-overview) و[نقطة نهاية /profiles API](/apis/profiles/overview).

## الوظائف الرئيسية

<ul class="custom-bullets">
  <li>[13 شبكة تواصل اجتماعي مدعومة](/introduction#which-social-networks-are-supported).</li>
  <li>وصول آمن إلى API باستخدام مفتاح API الفريد الخاص بك.</li>
  <li>النشر المُجدول إلى منصات التواصل الاجتماعي المتصلة.</li>
  <li>النشر التلقائي بناءً على جداول محددة مسبقًا.</li>
  <li>دعم محتوى الصور والفيديو، بما في ذلك Reels وStories وSpotlight.</li>
  <li>حذف المنشورات على شبكات التواصل الاجتماعي المربوطة.</li>
  <li>تحليلات تفاعل شاملة للمنشورات (الإعجابات والمشاركات وما إلى ذلك).</li>
  <li>مقاييس الحساب الاجتماعي، بما في ذلك عدد المتابعين والبيانات الديموغرافية.</li>
  <li>إدارة التعليقات: عرض تعليقات المنشورات وإضافتها وحذفها.</li>
  <li>اختصار الروابط الاختياري لجميع أو لروابط محددة في المنشورات.</li>
  <li>تكامل Unsplash: إضافة صور معينة أو اختيارها عشوائيًا بناءً على كلمات مفتاحية.</li>
  <li>خيار إنشاء وسوم تلقائيًا باستخدام كلمات مفتاحية ذات صلة.</li>
  <li>تتبع سجل المنشورات، بما في ذلك المنشورات غير الخاصة بـ Ayrshare.</li>
  <li>إدارة المراجعات: استرجاع الردود على المراجعات والرد عليها وحذفها.</li>
  <li>تكامل موجز RSS لنشر المحتوى تلقائيًا.</li>
  <li>مكتبة الوسائط: تحميل وتخزين الصور ومقاطع الفيديو للاستخدام في المنشورات.</li>
  <li>[نظام التحقق من المنشورات الاجتماعية](/testing/post-verification) للحفاظ على أمان حسابات التواصل الاجتماعي الخاصة بك.</li>
</ul>

## خطة Business وخطة Launch

ميزات [خطة Business](/multiple-users/business-plan-overview) و[خطة Launch](/multiple-users/business-launch-overview) لإدارة عدة مستخدمين وعملاء:

<ul class="custom-bullets">
  <li>تمكين المستخدمين من ربط حسابات وسائل التواصل الاجتماعي الخاصة بهم بمنصتك.</li>
  <li>تسجيل دخول أحادي آمن باستخدام OAuth لربط الحسابات بسرعة.</li>
  <li>إنشاء ملفات المستخدمين وإزالتها برمجيًا من خلال API.</li>
  <li>الوصول إلى تحليلات مستخدمين متقدمة.</li>
  <li>دعم Webhook للتحديثات الفورية.</li>
  <li>إدارة الرسائل المباشرة عبر المنصات المدعومة.</li>
  <li>إنشاء إعلانات Facebook من منشورات موجودة.</li>
</ul>

تواصل معنا لمعرفة المزيد عن [خطة Business](https://www.ayrshare.com/business-plan-for-multiple-users/).

## واجهة برمجة تطبيقات الإعلانات

تسمح لك [واجهة برمجة تطبيقات الإعلانات](/apis/ads/overview) بإنشاء إعلانات Facebook من منشورات موجودة.

<ul class="custom-bullets">
  <li>تعزيز المنشورات للوصول إلى مزيد من الأشخاص.</li>
  <li>إدارة الإعلانات وتتبع الأداء.</li>
  <li>تحليل الإنفاق الإعلاني وتحسين الحملات.</li>
</ul>

<Card title="Ads API" icon="code" href="/apis/ads/overview" horizontal>
  استكشف واجهة برمجة تطبيقات الإعلانات
</Card>

## واجهة برمجة تطبيقات الرسائل

[واجهة برمجة تطبيقات موحّدة للرسائل](/apis/messages/overview) للتفاعل مع المستخدمين في محادثات عبر أهم قنوات التواصل الاجتماعي: Facebook وInstagram وX.

<ul class="custom-bullets">
  <li>إرسال رسائل نصية وصور وفيديو.</li>
  <li>استرجاع سجلات المحادثة الكاملة.</li>
  <li>إعداد ردود تلقائية على الرسائل.</li>

  <li>
    تلقي تحديثات فورية عبر webhooks للرسائل المُستلمة والتفاعلات مع الرسائل وإيصالات
    القراءة.
  </li>
</ul>

تُبسِّط واجهة API هذه التفاعل مع المستخدمين من خلال مركزة عمليات المراسلة لقنوات التواصل الاجتماعي المتعددة. اعرف المزيد...

<Card title="Messages API" icon="code" href="/apis/messages/overview" horizontal>
  استكشف واجهة برمجة تطبيقات المراسلة الموحّدة
</Card>

## Max Pack

احصل على المزيد من الإمكانات مع إضافة [Max Pack](/additional/maxpack):

<Card title="Max Pack" icon="link" href="/additional/maxpack" horizontal>
  افتح ميزات متقدمة مثل إنشاء المحتوى بالذكاء الاصطناعي والتحليلات المُحسَّنة ودعم منصات
  موسّع مع إضافة Max Pack.
</Card>

## شاهد كيفية استخدام Social API

إذا كنت تبني بـ Node.js، فتحقق من هذا الفيديو حول كيفية الاتصال ونشر المنشورات على X وFacebook.

<div class="video-container">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/OMtj2h6sW6U" title="How to Use Ayrshare's Social API" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" />
</div>

## عرض توضيحي لـ Social API

إذا كنت تستخدم Node.js، فراجع كود العرض التوضيحي لـ social API للبدء في بناء تكامل social API الخاص بك.

<Card title="Social API Demo" icon="github" href="https://github.com/ayrshare/social-api-demo" horizontal>
  استكشف كود العرض التوضيحي لـ Node.js لبدء تكامل social API الخاص بك
</Card>

## عنوان URL الأساسي

عنوان URL الأساسي لواجهة برمجة تطبيقات Ayrshare هو نفسه لجميع نقاط النهاية.

`https://api.ayrshare.com/api`

## المصادقة

يقوم Ayrshare بمصادقة طلبات API عبر رمز Authorization يُمرَّر في ترويسة HTTP. يُرجى التأكد من إرسال `Bearer` مع مفتاح API. يمكن العثور على مفتاح API في لوحة تحكم Ayrshare بالتبديل إلى ملفك الشخصي الرئيسي.

إذا كنت مستخدم Business أو Enterprise، فيمكنك إنشاء ملفات مستخدمين مع مفاتيح ملف شخصي لإدارة عدة عملاء. يُستخدم مفتاح الملف الشخصي في ترويسة طلباتك.
يجب أيضًا استخدام مفتاح API في ترويسة طلباتك لملفات المستخدمين.

<Tip>
  يجب أن تستخدم خطط Premium مفتاح API فقط في ترويسة طلباتها. أما خطط Business وEnterprise
  فيجب أن تستخدم مفتاح الملف الشخصي في ترويسة طلباتها عند التفاعل نيابةً عن
  ملف مستخدم.
</Tip>

### صيغة مفتاح API

`Authorization: Bearer API_KEY` مع استبدال API\_KEY بمفتاح API الخاص بملفك الشخصي الرئيسي، والذي يمكن [العثور عليه في لوحة تحكم Ayrshare](/quickstart#get-your-api-key).

<CodeGroup>
  ```bash cURL theme={"system"}
  curl -H "Authorization: Bearer API_KEY" \
       -X GET https://api.ayrshare.com/api
  ```

  ```javascript JavaScript theme={"system"}
  headers: {"Authorization": "Bearer API_KEY"}
  ```

  ```python Python theme={"system"}
  headers = {"Authorization": "Bearer API_KEY"}
  ```

  ```php PHP theme={"system"}
  $headers = ["Authorization" => "Bearer API_KEY"];
  ```

  ```go Go theme={"system"}
  headers := map[string]string{"Authorization": "Bearer API_KEY"}
  ```

  ```ruby Ruby theme={"system"}
  headers = {"Authorization": "Bearer API_KEY"}
  ```

  ```java Java theme={"system"}
  headers = {"Authorization": "Bearer API_KEY"}
  ```

  ```csharp C# theme={"system"}
  headers = {"Authorization": "Bearer API_KEY"}
  ```

  ```rust Rust theme={"system"}
  headers = {"Authorization": "Bearer API_KEY"}
  ```
</CodeGroup>

<Note>
  احصل على مفتاح API السري الخاص بك في لوحة تحكم Ayrshare ضمن صفحة API Key الموجودة في لوحة التنقل اليسرى.

  على سبيل المثال، إذا كان مفتاح API الخاص بك هو 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

  يجب أن تتضمن الترويسة:

  `Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA`
</Note>

### صيغة مفتاح الملف الشخصي

يُستخدم مفتاح الملف الشخصي للتفاعل نيابةً عن ملف مستخدم.
هذا متاح فقط لخطط Business أو Enterprise.

`Profile-Key: PROFILE_KEY` مع استبدال PROFILE\_KEY بـ [مفتاح الملف الشخصي](/multiple-users/manage-user-profiles#get-the-profile-key) للمستخدم.

**تضمين مفتاح الملف الشخصي في الترويسة مطلوب للتفاعل نيابةً عن ملف مستخدم**.

سيؤدي غياب مفتاح API للملف الشخصي الرئيسي أو استخدام مفتاح الملف الشخصي بدلًا من مفتاح API في الترويسة إلى خطأ.

فيما يلي كيفية هيكلة الترويسات لطلبات API:

<CodeGroup>
  ```bash cURL theme={"system"}
  curl -H "Authorization: Bearer API_KEY" \ 
       -H "Profile-Key: PROFILE_KEY" \
       -X GET https://api.ayrshare.com/api
  ```

  ```javascript JavaScript theme={"system"}
  headers: {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY"
  }
  ```

  ```python Python theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY"
  }
  ```

  ```php PHP theme={"system"}
  $headers = [
    "Authorization" => "Bearer API_KEY",
    "Profile-Key" => "PROFILE_KEY"
  ];
  ```

  ```go Go theme={"system"}
  headers := map[string]string{
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY"
  }
  ```

  ```ruby Ruby theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY"
  }
  ```

  ```java Java theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY"
  }
  ```

  ```csharp C# theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY"
  }
  ```

  ```rust Rust theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY"
  }
  ```
</CodeGroup>

<Note>
  [ابحث عن مفتاح الملف الشخصي](/multiple-users/manage-user-profiles#get-the-profile-key) في لوحة تحكم Ayrshare ضمن صفحة Profile Key الموجودة في لوحة التنقل اليسرى.
  بدّل إلى الملف الشخصي الذي تريد استخدامه في صفحة User Profile.
  بالإضافة إلى ذلك، يُعاد مفتاح الملف الشخصي في استجابة نقطة نهاية [إنشاء ملف مستخدم](/apis/profiles/create-profile).

  يمكنك بعد ذلك استخدام مفتاح الملف الشخصي في ترويسة طلباتك:

  على سبيل المثال، إذا كان مفتاح الملف الشخصي الخاص بك هو `AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA`

  يجب أن تتضمن الترويسة كل من API ومفتاح الملف الشخصي:

  `Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA`

  `Profile-Key: AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA`
</Note>

### بيانات اعتماد BYO الخاصة بـ X/Twitter

بدءًا من 31 مارس 2026، ستتطلب جميع عمليات X/Twitter عبر Ayrshare بيانات اعتماد OAuth 1.0a الخاصة بك. بعد ربط حساب X عبر OAuth، مرّر هاتين الترويستين إلى جانب ترويسات `Authorization` (و`Profile-Key` الاختيارية) لأي طلب يستهدف X/Twitter:

| الترويسة                      | الوصف                                              |
| ----------------------------- | -------------------------------------------------- |
| `X-Twitter-OAuth1-Api-Key`    | مفتاح API الخاص بـ OAuth 1.0a (Consumer Key)       |
| `X-Twitter-OAuth1-Api-Secret` | سر مفتاح API الخاص بـ OAuth 1.0a (Consumer Secret) |

هذه الترويسات مطلوبة بعد 31 مارس 2026. سيتم رفض الطلبات إلى نقاط نهاية X/Twitter بدون بيانات اعتماد BYO صالحة.

<Info>
  **زوج مفاتيح واحد، يُستخدم لكل طلب.** تقوم بإنشاء تطبيق واحد على X Developer App لكل حساب Ayrshare وتستخدم القيم نفسها لـ `X-Twitter-OAuth1-Api-Key` و`X-Twitter-OAuth1-Api-Secret` على كل طلب يستهدف X، بغض النظر عن الملف الفرعي (`Profile-Key`) الذي يخص الطلب. أنت لا تُولّد أو تُدير المفاتيح لكل عميل أو لكل مستخدم نهائي.
</Info>

راجع [دليل إعداد مفتاح X BYO](/dashboard/connect-social-accounts/x-twitter-byo-keys) للحصول على تعليمات خطوة بخطوة وأمثلة الكود واستكشاف الأخطاء وإصلاحها.

تنطبق الترويستان نفسهما عند قيادة X/Twitter عبر [خادم MCP](/additional/mcp-action-server) — راجع [الاتصال والإعداد](/additional/mcp-action-connect).

## نوع المحتوى

يجب دائمًا تعيين نوع المحتوى كـ `Content-Type: "application/json"` ما لم تحدد نقطة النهاية خلاف ذلك.

<CodeGroup>
  ```bash cURL theme={"system"}
  curl -H "Authorization: Bearer API_KEY" \ 
       -H "Profile-Key: PROFILE_KEY" \ # Optional
       -H "Content-Type: application/json" \
       -X GET https://api.ayrshare.com/api
  ```

  ```javascript JavaScript theme={"system"}
  headers: {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", // Optional
    "Content-Type": "application/json"
  }
  ```

  ```python Python theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", # Optional
    "Content-Type": "application/json"
  }
  ```

  ```php PHP theme={"system"}
  $headers = [
    "Authorization" => "Bearer API_KEY",
    "Profile-Key" => "PROFILE_KEY", # Optional
    "Content-Type" => "application/json"
  ];
  ```

  ```go Go theme={"system"}
  headers := map[string]string{
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", // Optional
    "Content-Type": "application/json"
  }
  ```

  ```ruby Ruby theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", # Optional
    "Content-Type": "application/json"
  }
  ```

  ```java Java theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", // Optional
    "Content-Type": "application/json"
  }
  ```

  ```csharp C# theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", // Optional
    "Content-Type": "application/json"
  }
  ```

  ```rust Rust theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", // Optional
    "Content-Type": "application/json"
  }
  ```
</CodeGroup>

## الضغط

يدعم Ayrshare الضغط لجميع طلبات API.
لتمكين الضغط، عيّن ترويسة `Accept-Encoding` إلى `deflate, gzip, br`.

```bash theme={"system"}
  Accept-Encoding: "deflate, gzip, br"
```

يُوصى بهذا لاستدعاء الاستجابات الكبيرة مثل [نقطة نهاية /history](/apis/history/overview).

<ul class="custom-bullets">
  <li>يتم ضغط الاستجابات التي تزيد عن 1024 بايت (1KB) فقط.</li>

  <li>
    ترتيب الضغط المستخدم: Brotli (br) أولًا، ثم gzip، ثم deflate. Brotli هو
    خوارزمية الضغط الأكثر كفاءة.
  </li>

  <li>
    تحتوي ترويسة الاستجابة على ترميز المحتوى المستخدم. على سبيل المثال: `content-encoding: br` إذا
    تم استخدام Brotli.
  </li>

  <li>
    اعرف المزيد عن الضغط وفوائد استخدامه في [مدونة
    Ayrshare](https://www.ayrshare.com/blog/http-compression-in-node-js-a-dive-into-gzip-deflate-and-brotli/).
  </li>
</ul>

<Tip>لا تنسَ فك ضغط الاستجابة بشكل صحيح باستخدام ترميز المحتوى.</Tip>

<CodeGroup>
  ```bash cURL theme={"system"}
  curl -H "Authorization: Bearer API_KEY" \ 
       -H "Profile-Key: PROFILE_KEY" \ # Optional
       -H "Content-Type: application/json" \
       -H "Accept-Encoding: deflate, gzip, br" \ 
       -X GET https://api.ayrshare.com/api
  ```

  ```javascript JavaScript theme={"system"}
  headers: {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", // Optional
    "Content-Type": "application/json",
    "Accept-Encoding": "deflate, gzip, br"
  }
  ```

  ```python Python theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", # Optional
    "Content-Type": "application/json",
    "Accept-Encoding": "deflate, gzip, br"
  }
  ```

  ```php PHP theme={"system"}
  $headers = [
    "Authorization" => "Bearer API_KEY",
    "Profile-Key" => "PROFILE_KEY", # Optional
    "Content-Type" => "application/json",
    "Accept-Encoding" => "deflate, gzip, br"
  ];
  ```

  ```go Go theme={"system"}
  headers := map[string]string{
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", // Optional
    "Content-Type": "application/json",
    "Accept-Encoding": "deflate, gzip, br"
  }
  ```

  ```ruby Ruby theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", # Optional
    "Content-Type": "application/json",
    "Accept-Encoding": "deflate, gzip, br"
  }
  ```

  ```java Java theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", // Optional
    "Content-Type": "application/json",
    "Accept-Encoding": "deflate, gzip, br"
  }
  ```

  ```csharp C# theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", // Optional
    "Content-Type": "application/json",
    "Accept-Encoding": "deflate, gzip, br"
  }
  ```

  ```rust Rust theme={"system"}
  headers = {
    "Authorization": "Bearer API_KEY",
    "Profile-Key": "PROFILE_KEY", // Optional
    "Content-Type": "application/json",
    "Accept-Encoding": "deflate, gzip, br"
  }
  ```
</CodeGroup>

## أنواع المعرّفات

هناك عدة أنواع من المعرّفات المُعادة، ويمكن استخدامها في نقاط نهاية متعددة:

### معرّف منشور Ayrshare

يتم توليد هذا المعرّف بواسطة Ayrshare ويُعاد من
[نقطة نهاية /post](/apis/post/post) في حقل `id`. يسهّل هذا المعرّف
الحصول على تحليلات للمنشور عبر شبكات التواصل الاجتماعي، وإضافة تعليقات على
المنشور، وحذف المنشور، وما إلى ذلك. هذا هو المعرّف الذي ستستخدمه في أغلب الأحيان.

### معرّف المنشور الاجتماعي

تُعيّن كل شبكة تواصل اجتماعي معرّفها الفريد للمنشورات والتعليقات.
تُعاد هذه المعرّفات في حقل `postIds` من نقاط نهاية /post أو /comments.
يمكنك استخدام هذه المعرّفات، أو تلك التي تحصل عليها مباشرةً من شبكات التواصل الاجتماعي، لاسترجاع البيانات، مثل [معرّف المنشور الاجتماعي للتحليلات](/apis/analytics/social-by-id).

### معرّف تعليق Ayrshare

يتم توليد هذا المعرّف بواسطة Ayrshare ويُعاد من
[نقطة نهاية /comments](/apis/comments/post-comment) في حقل `id`. يسهّل هذا المعرّف
الحصول على تحليلات للتعليق عبر شبكات التواصل الاجتماعي، وإضافة ردود على
التعليق، وحذف التعليق، وما إلى ذلك. هذا هو المعرّف الذي ستستخدمه في أغلب الأحيان.

يُستخدم هذا غالبًا إذا كنت تريد الحصول على تفاصيل حول تعليق معيّن نُشر عبر Ayrshare.

### معرّف التعليق الاجتماعي

تُعيّن كل شبكة تواصل اجتماعي معرّفها الفريد للتعليقات.
تُعاد هذه المعرّفات في حقل `commentId` من [نقطة نهاية GET /comments](/apis/comments/get-comments).

يُستخدم هذا غالبًا إذا كنت تريد الحصول على تفاصيل حول تعليق معيّن نُشر خارج Ayrshare.

## رموز الأخطاء

ستعود الأخطاء [برموز حالة HTTP القياسية](https://tools.ietf.org/html/rfc2616#section-10).

لمزيد من المعلومات:

<Card title="HTTP Status Codes" icon="link" horizontal href="/errors/errors-http">
  اعرف المزيد عن رموز حالة HTTP
</Card>

توجد الأخطاء المفصّلة في استجابة REST API الخاصة بكل نوع من الاستدعاءات.

لمزيد من المعلومات:

<Card title="Ayrshare Error Codes" icon="link" horizontal href="/errors/errors-ayrshare">
  اعرف المزيد عن رموز الأخطاء الخاصة بـ Ayrshare
</Card>

## صيغة الطابع الزمني

يستخدم Ayrshare توقيت زولو، المعروف أيضًا بـ UTC (Coordinated Universal Time) أو سلسلة تاريخ بصيغة ISO 8601، للحصول على مراجع زمنية دقيقة وواضحة عبر مناطق زمنية مختلفة.

على سبيل المثال، استخدم الصيغة `YYYY-MM-DDThh:mm:ssZ` وأرسلها كـ `2026-07-08T12:30:00Z`.
يُرجى الاطلاع على [utctime](https://www.utctime.net/) لمزيد من الأمثلة.

يمكنك تحويل صيغة UTC إلى وقتك المحلي بلغة البرمجة التي تختارها. على سبيل المثال في JavaScript:

```javascript theme={"system"}
const convertToLocalTime = (isoString) => {
  // Create a new Date object from the ISO string
  const date = new Date(isoString);

  // Extract local time components
  const localDate = date.toLocaleDateString();
  const localTime = date.toLocaleTimeString();

  // Combine the local date and time
  const localDateTime = `${localDate} ${localTime}`;

  return localDateTime;
};
```

## Postman

يمكنك استخدام Postman لاختبار استدعاءات REST API الخاصة بك.

<Card title="Postman" icon="link" horizontal href="/testing/postman">
  تعرّف على كيفية استخدام Postman مع واجهة برمجة التطبيقات الخاصة بنا
</Card>

## المنشورات والصور والفيديوهات العشوائية

راجع [دليل البدء السريع](/quickstart#publish-test-posts) حول كيفية إرسال منشورات أو صور أو فيديوهات عشوائية عند الاختبار.

## الحزم

لدينا حزم Node.js وPython، وأدلة Bubble.io وAirtable وMake متاحة لتسهيل استدعاءات RESTful.

<CardGroup cols={2}>
  <Card title="Node NPM Package" icon="cube" iconType="duotone" href="/packages-guides/nodejs" horizontal>
    التكامل باستخدام حزمة NodeJS الخاصة بنا
  </Card>

  <Card title="Python PyPI Package" icon="cube" iconType="duotone" href="/packages-guides/python" horizontal>
    التكامل باستخدام حزمة Python الخاصة بنا
  </Card>

  <Card title="Airtable Guide" icon="book-open" iconType="duotone" href="/packages-guides/airtable" horizontal>
    تعرّف على كيفية استخدام Ayrshare مع Airtable
  </Card>

  <Card title="Bubble Plugin & Guide" icon="cube" iconType="duotone" href="/packages-guides/bubble" horizontal>
    تعرّف على كيفية استخدام Ayrshare مع Bubble.io
  </Card>

  <Card title="Make Guide" icon="book-open" iconType="duotone" href="/packages-guides/make" horizontal>
    تعرّف على كيفية استخدام Ayrshare مع Make
  </Card>

  <Card title="Notion Guide" icon="book-open" iconType="duotone" href="/packages-guides/notion" horizontal>
    تعرّف على كيفية استخدام Ayrshare مع Notion
  </Card>

  <Card title="FlutterFlow Guide" icon="book-open" iconType="duotone" href="/packages-guides/flutterflow" horizontal>
    تعرّف على كيفية استخدام Ayrshare مع FlutterFlow
  </Card>

  <Card title="Retool Guide" icon="book-open" iconType="duotone" href="/packages-guides/retool" horizontal>
    تعرّف على كيفية استخدام Ayrshare مع Retool
  </Card>
</CardGroup>