نظرة عامة على واجهة برمجة تطبيقات 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 ونظرة عامة على خطة Launch ونقطة نهاية /profiles API.

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

13 شبكة تواصل اجتماعي مدعومة.
وصول آمن إلى API باستخدام مفتاح API الفريد الخاص بك.
النشر المُجدول إلى منصات التواصل الاجتماعي المتصلة.
النشر التلقائي بناءً على جداول محددة مسبقًا.
دعم محتوى الصور والفيديو، بما في ذلك Reels وStories وSpotlight.
حذف المنشورات على شبكات التواصل الاجتماعي المربوطة.
تحليلات تفاعل شاملة للمنشورات (الإعجابات والمشاركات وما إلى ذلك).
مقاييس الحساب الاجتماعي، بما في ذلك عدد المتابعين والبيانات الديموغرافية.
إدارة التعليقات: عرض تعليقات المنشورات وإضافتها وحذفها.
اختصار الروابط الاختياري لجميع أو لروابط محددة في المنشورات.
تكامل Unsplash: إضافة صور معينة أو اختيارها عشوائيًا بناءً على كلمات مفتاحية.
خيار إنشاء وسوم تلقائيًا باستخدام كلمات مفتاحية ذات صلة.
تتبع سجل المنشورات، بما في ذلك المنشورات غير الخاصة بـ Ayrshare.
إدارة المراجعات: استرجاع الردود على المراجعات والرد عليها وحذفها.
تكامل موجز RSS لنشر المحتوى تلقائيًا.
مكتبة الوسائط: تحميل وتخزين الصور ومقاطع الفيديو للاستخدام في المنشورات.
نظام التحقق من المنشورات الاجتماعية للحفاظ على أمان حسابات التواصل الاجتماعي الخاصة بك.

خطة Business وخطة Launch

ميزات خطة Business وخطة Launch لإدارة عدة مستخدمين وعملاء:

تمكين المستخدمين من ربط حسابات وسائل التواصل الاجتماعي الخاصة بهم بمنصتك.
تسجيل دخول أحادي آمن باستخدام OAuth لربط الحسابات بسرعة.
إنشاء ملفات المستخدمين وإزالتها برمجيًا من خلال API.
الوصول إلى تحليلات مستخدمين متقدمة.
دعم Webhook للتحديثات الفورية.
إدارة الرسائل المباشرة عبر المنصات المدعومة.
إنشاء إعلانات Facebook من منشورات موجودة.

تواصل معنا لمعرفة المزيد عن خطة Business.

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

تسمح لك واجهة برمجة تطبيقات الإعلانات بإنشاء إعلانات Facebook من منشورات موجودة.

تعزيز المنشورات للوصول إلى مزيد من الأشخاص.
إدارة الإعلانات وتتبع الأداء.
تحليل الإنفاق الإعلاني وتحسين الحملات.

Ads API

استكشف واجهة برمجة تطبيقات الإعلانات

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

واجهة برمجة تطبيقات موحّدة للرسائل للتفاعل مع المستخدمين في محادثات عبر أهم قنوات التواصل الاجتماعي: Facebook وInstagram وX.

إرسال رسائل نصية وصور وفيديو.
استرجاع سجلات المحادثة الكاملة.
إعداد ردود تلقائية على الرسائل.
تلقي تحديثات فورية عبر webhooks للرسائل المُستلمة والتفاعلات مع الرسائل وإيصالات القراءة.

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

Messages API

استكشف واجهة برمجة تطبيقات المراسلة الموحّدة

Max Pack

احصل على المزيد من الإمكانات مع إضافة Max Pack:

Max Pack

افتح ميزات متقدمة مثل إنشاء المحتوى بالذكاء الاصطناعي والتحليلات المُحسَّنة ودعم منصات موسّع مع إضافة Max Pack.

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

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

Social API Demo

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

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

عنوان URL الأساسي لواجهة برمجة تطبيقات Ayrshare هو نفسه لجميع نقاط النهاية. https://api.ayrshare.com/api

المصادقة

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

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

صيغة مفتاح API

Authorization: Bearer API_KEY مع استبدال API_KEY بمفتاح API الخاص بملفك الشخصي الرئيسي، والذي يمكن العثور عليه في لوحة تحكم Ayrshare.

curl -H "Authorization: Bearer API_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

$headers = ["Authorization" => "Bearer API_KEY"];

headers := map[string]string{"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

احصل على مفتاح API السري الخاص بك في لوحة تحكم Ayrshare ضمن صفحة API Key الموجودة في لوحة التنقل اليسرى.على سبيل المثال، إذا كان مفتاح API الخاص بك هو 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAيجب أن تتضمن الترويسة:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

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

يُستخدم مفتاح الملف الشخصي للتفاعل نيابةً عن ملف مستخدم. هذا متاح فقط لخطط Business أو Enterprise. Profile-Key: PROFILE_KEY مع استبدال PROFILE_KEY بـ مفتاح الملف الشخصي للمستخدم. تضمين مفتاح الملف الشخصي في الترويسة مطلوب للتفاعل نيابةً عن ملف مستخدم. سيؤدي غياب مفتاح API للملف الشخصي الرئيسي أو استخدام مفتاح الملف الشخصي بدلًا من مفتاح API في الترويسة إلى خطأ. فيما يلي كيفية هيكلة الترويسات لطلبات API:

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

ابحث عن مفتاح الملف الشخصي في لوحة تحكم Ayrshare ضمن صفحة Profile Key الموجودة في لوحة التنقل اليسرى. بدّل إلى الملف الشخصي الذي تريد استخدامه في صفحة User Profile. بالإضافة إلى ذلك، يُعاد مفتاح الملف الشخصي في استجابة نقطة نهاية إنشاء ملف مستخدم.يمكنك بعد ذلك استخدام مفتاح الملف الشخصي في ترويسة طلباتك:على سبيل المثال، إذا كان مفتاح الملف الشخصي الخاص بك هو AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EAيجب أن تتضمن الترويسة كل من API ومفتاح الملف الشخصي:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAProfile-Key: AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA

بيانات اعتماد 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 صالحة.

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

راجع دليل إعداد مفتاح X BYO للحصول على تعليمات خطوة بخطوة وأمثلة الكود واستكشاف الأخطاء وإصلاحها. تنطبق الترويستان نفسهما عند قيادة X/Twitter عبر خادم MCP — راجع الاتصال والإعداد.

نوع المحتوى

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

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

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

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json"
];

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

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

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

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

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

الضغط

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

  Accept-Encoding: "deflate, gzip, br"

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

يتم ضغط الاستجابات التي تزيد عن 1024 بايت (1KB) فقط.
ترتيب الضغط المستخدم: Brotli (br) أولًا، ثم gzip، ثم deflate. Brotli هو خوارزمية الضغط الأكثر كفاءة.
تحتوي ترويسة الاستجابة على ترميز المحتوى المستخدم. على سبيل المثال: content-encoding: br إذا تم استخدام Brotli.
اعرف المزيد عن الضغط وفوائد استخدامه في مدونة Ayrshare.

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

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

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

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

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

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

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

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

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

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

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

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

معرّف منشور Ayrshare

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

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

تُعيّن كل شبكة تواصل اجتماعي معرّفها الفريد للمنشورات والتعليقات. تُعاد هذه المعرّفات في حقل postIds من نقاط نهاية /post أو /comments. يمكنك استخدام هذه المعرّفات، أو تلك التي تحصل عليها مباشرةً من شبكات التواصل الاجتماعي، لاسترجاع البيانات، مثل معرّف المنشور الاجتماعي للتحليلات.

معرّف تعليق Ayrshare

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

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

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

رموز الأخطاء

ستعود الأخطاء برموز حالة HTTP القياسية. لمزيد من المعلومات:

HTTP Status Codes

اعرف المزيد عن رموز حالة HTTP

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

Ayrshare Error Codes

اعرف المزيد عن رموز الأخطاء الخاصة بـ Ayrshare

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

يستخدم Ayrshare توقيت زولو، المعروف أيضًا بـ UTC (Coordinated Universal Time) أو سلسلة تاريخ بصيغة ISO 8601، للحصول على مراجع زمنية دقيقة وواضحة عبر مناطق زمنية مختلفة. على سبيل المثال، استخدم الصيغة YYYY-MM-DDThh:mm:ssZ وأرسلها كـ 2026-07-08T12:30:00Z. يُرجى الاطلاع على utctime لمزيد من الأمثلة. يمكنك تحويل صيغة UTC إلى وقتك المحلي بلغة البرمجة التي تختارها. على سبيل المثال في JavaScript:

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 الخاصة بك.

Postman

تعرّف على كيفية استخدام Postman مع واجهة برمجة التطبيقات الخاصة بنا

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

راجع دليل البدء السريع حول كيفية إرسال منشورات أو صور أو فيديوهات عشوائية عند الاختبار.

الحزم

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

Node NPM Package

التكامل باستخدام حزمة NodeJS الخاصة بنا

Python PyPI Package

التكامل باستخدام حزمة Python الخاصة بنا

Airtable Guide

تعرّف على كيفية استخدام Ayrshare مع Airtable

Bubble Plugin & Guide

تعرّف على كيفية استخدام Ayrshare مع Bubble.io

Make Guide

تعرّف على كيفية استخدام Ayrshare مع Make

Notion Guide

تعرّف على كيفية استخدام Ayrshare مع Notion

FlutterFlow Guide

تعرّف على كيفية استخدام Ayrshare مع FlutterFlow

Retool Guide

تعرّف على كيفية استخدام Ayrshare مع Retool

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

​خطة Business وخطة Launch

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

Ads API

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

Messages API

​Max Pack

Max Pack

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

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

Social API Demo

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

​المصادقة

​صيغة مفتاح API

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

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

​نوع المحتوى

​الضغط

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

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

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

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

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

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

HTTP Status Codes

Ayrshare Error Codes

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

​Postman

Postman

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

​الحزم

Node NPM Package

Python PyPI Package

Airtable Guide

Bubble Plugin & Guide

Make Guide

Notion Guide

FlutterFlow Guide

Retool Guide

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

خطة Business وخطة Launch

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

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

Max Pack

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

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

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

المصادقة

صيغة مفتاح API

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

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

نوع المحتوى

الضغط

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

معرّف منشور Ayrshare

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

معرّف تعليق Ayrshare

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

رموز الأخطاء

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

Postman

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

الحزم