الانتقال إلى المحتوى الرئيسي
هذا الدليل مخصص لإعداد شركة واحدة. لاشتراكات خطة Business وEnterprise متعددة المستخدمين، يتم توفير دليل تكامل مخصص.

قم بتوصيل حسابات وسائل التواصل الاجتماعي الخاصة بك

سجّل الدخول أو أنشئ حساب Ayrshare. في صفحة Social Account، انقر على شبكات التواصل الاجتماعي التي تريد توصيلها. يُرجى التأكد من منح جميع الأذونات.

Facebook Linking Example

احصل على مفتاح API الخاص بك

مفتاح API مطلوب لتفويض الوصول إلى نقاط نهاية API. يُستخدم هذا المفتاح في ترويسة طلباتك، ويجب أن يسبقه الكلمة الأساسية Bearer. يوجد مفتاح API الخاص بك داخل لوحة تحكم Ayrshare، في صفحة API Key. إذا لزم الأمر، بدّل إلى ‘Primary Profile’ عبر صفحة User Profiles. من هناك، يمكنك العثور على صفحة API Key في اللوحة الجانبية اليسرى. API Key يجب أن يتضمن كل استدعاء API مفتاح API في الترويسة باستخدام رمز Bearer. قم أيضًا بتضمين Content-Type بقيمة application/json.
Header
راجع المصادقة لمزيد من المعلومات.

أرسل أول منشور API لك

نشر المنشور

فيما يلي أمثلة كود توضح كيفية إجراء منشور باستخدام واجهة API الخاصة بنا بلغات برمجة مختلفة. لتكامل أسهل، يمكنك استخدام إحدى حزم SDK الجاهزة الخاصة بنا. لإجراء منشور، ستحتاج إلى:
  • مفتاح API الخاص بك للمصادقة.
  • المحتوى النصي لمنشورك.
  • منصات وسائل التواصل الاجتماعي التي تريد النشر عليها (قم بتضمين المنصات التي قمت بربطها فقط).
  • اختياري: عناوين URL لأي صور أو فيديوهات تريد تضمينها.
تستخدم جميع الأمثلة نقطة النهاية /post. لنلقِ نظرة على بعض أمثلة الكود:
تنشر على X/Twitter؟ يتطلب X بيانات اعتماد API الخاصة بك. أضف ترويستَي BYO (X-Twitter-OAuth1-Api-Key وX-Twitter-OAuth1-Api-Secret) إلى طلبك. هذا إعداد لمرة واحدة لكل حساب Ayrshare، ويعمل زوج المفاتيح نفسه لكل ملف فرعي / مستخدم نهائي. راجع دليل الإعداد للتفاصيل.
تهانينا! لقد أرسلت للتو أول منشور لك.

استجابة المنشور

ستتلقى استجابة بحالة status “success” عندما تعالج واجهة API الخاصة بنا منشورك بنجاح. تتضمن الاستجابة:
  • status: الحالة العامة لاستدعاء API (“success” أو “error”)
  • errors: مصفوفة من أي أخطاء تم مواجهتها (فارغة إذا نجحت)
  • postIds: مصفوفة من الكائنات تحتوي على تفاصيل خاصة بالمنصة:
    • اسم المنصة
    • معرّف المنشور على تلك المنصة
    • عنوان URL لعرض المنشور
    • معلومات إضافية خاصة بالمنصة
سيكون لكل منصة في مصفوفة postIds حالتها الخاصة، مما يتيح لك التحقق من المنصات التي استلمت منشورك بنجاح. تحقق من صفحات وسائل التواصل الاجتماعي الخاصة بك للتأكد من أن المنشور قد تمت معالجته بنجاح وأنه مباشر. لاحظ أن بعض المنصات قد تشهد تأخيرًا طفيفًا قبل ظهور المنشورات علنًا. فيما يلي عيّنة من الاستجابة:
Post Response
راجع المزيد من أمثلة الكود لاستدعاء واجهة API لوسائل التواصل الاجتماعي بلغات Node.js وPython وPHP وGolang وC# وRuby، بالإضافة إلى إمكانات رائعة أخرى:

Post

الغوص قليلًا في العمق

لنقسّم عملية ما حدث للتو عندما أجرينا هذا الاستدعاء لواجهة API.
1

تعيين الترويسة

قمنا بتعيين رمز Header Authorization bearer (مفتاح API) ونوع المحتوى كـ json.
2

إنشاء كائن Body

بعد ذلك، أنشأنا كائن body:
  • Post يحتوي على النص “Today is a great day!”.
  • منصات شبكات التواصل الاجتماعي هي Facebook وInstagram وLinkedIn. يجب أن تُضمّن فقط المنصات التي ربطتها في صفحة Social Linkage.
  • أضفنا صورة في mediaUrls.
3

استدعاء نقطة نهاية /post

أرسلنا كل شيء كـ HTTP POST إلى نقطة نهاية /post.

قبل أن تذهب، بعض أفضل الممارسات

اقرأ الوثائق

نحتفظ بوثائق شاملة ومحدّثة. بما أنك هنا بالفعل، خذ بعض الوقت للاطلاع على أقسام الوثائق في التنقل الأيسر.

رموز الأخطاء مهمة

عليك التعامل معها حتى يحظى المستخدمون بتجربة رائعة.

الأخطاء

حافظ على أمان مفتاح API الخاص بك

نحن نأخذ الأمان على محمل الجد، وينبغي عليك ذلك أيضًا. لديك سيطرة كاملة على الاتصال بين Ayrshare وحسابات وسائل التواصل الاجتماعي الخاصة بك. بمجرد توصيل الحسابات، يصبح مفتاح Ayrshare API هو الطريقة التي تُصادق بها. يُرجى الحفاظ على هذا المفتاح سريًا وآمنًا.

نشر منشورات اختبار

يمكنك نشر منشورات اختبار باقتباس أو صورة أو فيديو عشوائي باستخدام معاملات randomPost وrandomMediaUrl وisLandscapeVideo أو isPortraitVideo في نقطة نهاية /post. إذا استخدمت randomPost، فمعامل post غير مطلوب.
هذه المنشورات مباشرة على صفحات وسائل التواصل الاجتماعي الخاصة بك، لذا إذا كان مناسبًا، احذفها بعد الاختبار.

اقتباس عشوائي

أرسل اقتباسًا عشوائيًا لاختبار نشر منشور بإضافة randomPost: true. يُستخدم مع نقطة نهاية /post.

صورة عشوائية

أرسل صورة عشوائية بإضافة randomMediaUrl: true. يُستخدم مع نقطة نهاية /post.

فيديو عشوائي

أرسل فيديو أفقيًا عشوائيًا بإضافة isVideo: true وisLandscapeVideo: true. سيكون الفيديو بحجم أفقي قياسي. يُستخدم مع نقطة نهاية /post.
أرسل فيديو عموديًا عشوائيًا، المطلوب لـ TikTok أو Facebook/Instagram Reels، بإضافة isVideo: true وisPortraitVideo: true. يُستخدم مع نقطة نهاية /post.

تعليق عشوائي

أرسل تعليقًا عشوائيًا لاختبار نشر تعليق بإضافة randomComment: true. يُستخدم مع نقطة نهاية /comment.

مثال على استدعاء cURL

أرسل اقتباسًا عشوائيًا وفيديو عموديًا.

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

Postman هو أداة مذهلة لاختبار استدعاءات API. يمكنك حتى توليد كود بأكثر من اثنتي عشرة لغة.

كود العرض التوضيحي

إذا كنت تبحث عن مشروع عرض توضيحي عيّنة في React وNodeJS، يُرجى الاطلاع على مستودع GitHub هذا:

Github Social Posting Demo App

استكشاف الأخطاء الشائعة وإصلاحها

أحيانًا لا تسير الأمور على ما يرام، لذا إليك بعض المساعدة في مركز المساعدة الخاص بنا.

Troubleshooting

تواصل معنا للحصول على المساعدة

نحن هنا للمساعدة، لذا يُرجى استخدام الدردشة في الزاوية اليمنى السفلى أو مراسلتنا عبر البريد الإلكتروني.