قم بتوصيل حسابات وسائل التواصل الاجتماعي الخاصة بك
سجّل الدخول أو أنشئ حساب Ayrshare. في صفحة Social Account، انقر على شبكات التواصل الاجتماعي التي تريد توصيلها. يُرجى التأكد من منح جميع الأذونات.
احصل على مفتاح API الخاص بك
مفتاح API مطلوب لتفويض الوصول إلى نقاط نهاية API. يُستخدم هذا المفتاح في ترويسة طلباتك، ويجب أن يسبقه الكلمة الأساسيةBearer.
يوجد مفتاح API الخاص بك داخل لوحة تحكم Ayrshare، في صفحة API Key. إذا لزم الأمر، بدّل إلى ‘Primary Profile’ عبر صفحة User Profiles.
من هناك، يمكنك العثور على صفحة API Key في اللوحة الجانبية اليسرى.

Bearer. قم أيضًا بتضمين Content-Type بقيمة application/json.
Header
أرسل أول منشور API لك
نشر المنشور
فيما يلي أمثلة كود توضح كيفية إجراء منشور باستخدام واجهة API الخاصة بنا بلغات برمجة مختلفة. لتكامل أسهل، يمكنك استخدام إحدى حزم SDK الجاهزة الخاصة بنا. لإجراء منشور، ستحتاج إلى:- مفتاح API الخاص بك للمصادقة.
- المحتوى النصي لمنشورك.
- منصات وسائل التواصل الاجتماعي التي تريد النشر عليها (قم بتضمين المنصات التي قمت بربطها فقط).
- اختياري: عناوين URL لأي صور أو فيديوهات تريد تضمينها.
تنشر على 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
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.
isVideo: true وisPortraitVideo: true.
يُستخدم مع نقطة نهاية /post.
تعليق عشوائي
أرسل تعليقًا عشوائيًا لاختبار نشر تعليق بإضافةrandomComment: true.
يُستخدم مع نقطة نهاية /comment.
