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

تتيح لك نقطة نهاية النشر نشر منشورات على الشبكات الاجتماعية: Bluesky وFacebook وGoogle Business Profile وInstagram وLinkedIn وPinterest وReddit وSnapchat وTelegram وTikTok وX/Twitter وYouTube. هناك العديد من الخيارات لتخصيص منشورك، مثل جدولة المنشورات وإضافة الهاشتاغات التلقائية وجدولة النشر التلقائي والمزيد. غالبًا ما تستخدمها الوكالات عندما يحتاج العديد من أصحاب المصلحة إلى الموافقة على منشور قبل نشره. ابدأ بنشر المنشورات باستخدام نقطة نهاية /post POST.

سير عمل الموافقة

إذا كان سير عمل النشر لديك يتطلب الموافقة قبل إرسال منشور، فقم بضبط حقل requiresApproval على true. هذا يعادل إيقاف المنشور مؤقتًا حتى يتم تعيين المعلمة approved على true.

مثال على سير عمل الموافقة

سيكون للمنشور حالة “بانتظار الموافقة” حتى يتم تعيين المعلمة approved على true عبر نقطة نهاية /post PATCH.

النشر مع المعلمات

انشر منشورك باستخدام نقطة نهاية /post مع حقل requiresApproval كـ true. يمكنك أيضًا تضمين معلمات قياسية مثل scheduleDate.

الحالة بانتظار الموافقة

سيكون المنشور في حالة “بانتظار الموافقة” وسيتم الاحتفاظ به حتى يتم منح الموافقة.

الموافقة على المنشور

قم بتحديث المنشور باستخدام عملية /post PATCH وضبط حقل approved على true. سيتم الآن إرسال المنشور في الوقت المحدد.

استخدام الملاحظات

اختياري: قم بتعيين notes على المنشور للرجوع إليها، مثل من يحتاج إلى الموافقة على المنشور.

Publish the Post with Approval

{
  "requiresApproval": true,
  "notes": "need approval by John Smith" // optional
}

إذا تم تضمين scheduleDate والتاريخ في الماضي، فسيتم نشر المنشور فورًا عند الموافقة.

فيديو سير عمل الموافقة

يُرجى مشاهدة الفيديو أدناه لمثال على سير عمل الموافقة.

الهاشتاغات التلقائية

أضف الهاشتاغات الأكثر صلة إلى منشورك. autoHashtag هو كائن أو قيمة منطقية Boolean - انظر أدناه، مع المعلمات التالية:

max: (اختياري) عدد صحيح للهاشتاغات المضافة، النطاق 1-10. الافتراضي 2.
position: (اختياري) سلسلة “auto” أو “end”. يضيف Auto الهاشتاغات داخل المنشور أو في النهاية. “end” يضيف الهاشتاغات فقط إلى النهاية.

تتطلب خطة مدفوعة.

{
  "hashtags": {
    "max": 3, // optional: Integer range 1-10
    "position": "auto" // optional: String "auto" or "end"
  }
}

إذا كنت لا تريد إرسال أي من الخيارات المذكورة أعلاه، مرّر القيمة المنطقية true بدلاً من كائن.

{
  "autoHashtag": true
}

إعادة النشر التلقائي

يعيد نشر محتواك تلقائيًا عدة مرات على فترات منتظمة، مما ينشئ محتوى دائم الخضرة يظل جديدًا ومرئيًا لجمهورك. تتطلب خطة مدفوعة. المعلمات:

repeat: (مطلوب) عدد مرات إعادة نشر المحتوى. يجب أن يكون بين 1 و 10.
days: (مطلوب) عدد الأيام بين كل إعادة نشر. يجب أن يكون على الأقل يومين.
startDate: (اختياري) متى يبدأ جدول إعادة النشر، بتنسيق ISO-8601 UTC. إذا لم يتم تحديده، فسيتم نشر المنشور الأول فورًا. يجب استخدام معلمة startDate بدلاً من معلمة scheduleDate عالية المستوى.

Auto Repost

{
  "repeat": 2, // min 2, max 10
  "days": 5, // min 2
  "startDate": "2021-07-08T12:30:00Z"
}

ستتضمن الاستجابة جميع عمليات إعادة النشر المجدولة المستقبلية وautoRepostId لكل إعادة نشر.

Auto Repost Response

{
  "status": "scheduled",
  "scheduleDate": "2025-06-13T12:30:00.000Z",
  "id": "eIT96IYEodNuzU4oMmwG",
  "refId": "9abf1426d6ce9122ef11c72bd",
  "autoRepostId": "F5wdoaOAAGtDQVciExSxL",
  "post": "The most important things are the hardest to say - Stephen King"
}

عند إنشاء إعادة نشر تلقائي، يتم تعيين معرف autoRepostId لتتبع تلك السلسلة من المنشورات. يمكنك الحصول على جميع عمليات إعادة النشر التلقائية لمنشور مع استدعاء History مع autoRepostId. إذا كنت بحاجة إلى حذف إعادة نشر، يمكنك استخدام استدعاء DELETE مع معرف المنشور.

مهم: عند استخدام إعادة النشر التلقائي، تأكد من اتباع إرشادات تكرار النشر لكل شبكة اجتماعية لتجنب قيود الحساب.ملاحظة: لا يمكن استخدام ميزة autoRepost مع scheduleDate. إذا قمت بتضمين كلا المعلمتين، فستكون الأولوية لـ scheduleDate وسيتم تجاهل autoRepost. يُرجى استخدام معلمة startDate بدلاً من ذلك.

التعليق الأول

أضف تلقائيًا تعليقًا أولاً، مع الوسائط، بعد نشر المنشور. بالنسبة لـ TikTok، يتم تأجيل التعليق حتى ينتهي معالجة الفيديو (راجع وقت معالجة التعليق الأول). يمكن أن يساعد نشر التعليق الأول على منشورك في وسائل التواصل الاجتماعي الخاصة بك في بدء التفاعل وتحديد نبرة المناقشة التي تليها.

{
  "firstComment": {
    "comment": "My first comment", // required
    "mediaUrls": ["https://..."] // Facebook, LinkedIn, and X/Twitter only
  }
}

وقت معالجة التعليق الأول

بالنسبة لمعظم الشبكات الاجتماعية، تتأخر استجابة واجهة برمجة التطبيقات لأن نظامنا يجب أن (1) ينتظر حتى يتم نشر المنشور الأصلي بالكامل، ثم (2) يضيف التعليق إلى ذلك المنشور المنشور. هذه العملية المتتابعة تضيف تأخيرًا يبلغ حوالي 20 ثانية. تتم معالجة TikTok بشكل مختلف. يعالج TikTok مقاطع الفيديو بشكل غير متزامن، لذا فإن id المنشور هو "pending" حتى تحل ويب هوك post.publish.publicly_available من TikTok معرف الفيديو الحقيقي (راجع معالجة TikTok). لذلك تُرجع استجابة /post تعليق TikTok الأول مع status: "pending" على الفور، ويتم نشر التعليق تلقائيًا بمجرد أن ينتهي TikTok من المعالجة ويتم إطلاق ويب هوك الإجراء المجدول tikTokPublished. لا يضمن TikTok وقت معالجة، لذا لا يوجد تأخير ثابت. ملاحظة مهمة حول TikTok: لكي تعمل التعليقات الأولى بشكل صحيح على TikTok، يجب أن يتم ضبط معلمة visibility للمنشور على public. لا يتلقى مقطع فيديو غير عام أبدًا ويب هوك publicly_available، لذا لا يمكن نشر تعليقه الأول؛ في هذه الحالة تُرجع Ayrshare خطأ التعليق بدلاً من تركه معلقًا.

المنشورات المتساوية القوة

التساوي في القوة (Idempotency) هي ميزة اختيارية تضمن تنفيذ الطلب مرة واحدة فقط، حتى إذا تم إرساله عن طريق الخطأ عدة مرات. عند نشر المحتوى باستخدام واجهة برمجة التطبيقات، يمكنك تضمين معلمة idempotencyKey اختيارية في نص الطلب لتحديد العملية بشكل فريد. يتيح لك ذلك إعادة محاولة طلب النشر بأمان دون خطر إنشاء منشورات مكررة. لاستخدام التساوي في القوة، أضف المعلمة idempotencyKey إلى نص JSON لطلب /post POST:

Idempotency Key

{
  "idempotencyKey": "Unique Key"
}

يجب أن تكون قيمة idempotencyKey سلسلة فريدة لكل ملف مستخدم. إذا تم إجراء طلب بنفس idempotencyKey لملف مستخدم معين، بغض النظر عن حالة المنشور (نجاح، خطأ، معلق، أو محذوف)، فسيتم إرجاع خطأ يشير إلى العثور على مفتاح مكرر.

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

يساعد استخدام التساوي في القوة على منع الإنشاء العرضي للمنشورات المكررة عند إعادة محاولة الطلبات الفاشلة أو التعامل مع مشكلات الشبكة. ومع ذلك، لا يزال يُوصى بتنفيذ آليات مناسبة لمعالجة الأخطاء وإعادة المحاولة في تطبيقك للتعامل مع الإخفاقات المحتملة بشكل سلس.

متطلبات الصور والفيديو

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

إرشادات الصور والفيديو

عنوان URL صالح

تأكد من أن عناوين URL للوسائط الخاصة بك صالحة وتصل مباشرة إلى الوسائط. اختبار أول هو تجربة عنوان URL في متصفح. إذا كانت الصورة لن تُحمّل أو لا يمكن تنزيلها في متصفح، فمن المحتمل أن تفشل. على سبيل المثال، عنوان URL لـ DropBox الذي يفتح تطبيق ويب DropBox لن يعمل.

إذا كان لديك عنوان URL لمشاركة Google Drive أو عنوان URL لمشاركة Dropbox، يمكنك فقط استخدام عنوان URL في معلمة mediaUrls عند نشر منشور أو تعليق. ستقوم Ayrshare تلقائيًا بتحويل عنوان URL للمشاركة إلى رابط تنزيل.

نقوم بالتحقق من عنوان URL للوسائط عن طريق إجراء طلب HEAD. يُرجى التأكد من أن مزود الاستضافة لا يحظر طلب HEAD وإلا سيفشل المنشور بخطأ 403. على سبيل المثال، إليك طلب HEAD لعنوان URL للوسائط:

Fetch HEAD Request

const run = async () => {
  const url = "https://img.ayrshare.com/012/gb.jpg";
  return await fetch(url, {
    method: "HEAD"
  })
    .then((res) => {
      if (res.ok) {
        return console.log("Success:", res.status, res.statusText);
      } else {
        return console.error("Error:", res.status, res.statusText, res);
      }
    })
    .catch((error) => {
      return console.error("Error Catch:", error);
    });
};

run();

حماية الوسائط الآلية

تتضمن Ayrshare حماية وسائط مدمجة يمكنها اكتشاف وحل مشكلات معينة في تسليم الوسائط أثناء النشر. عندما ينجح المنشور ولكن تم اكتشاف مشكلة محتوى وحلها، تتضمن كل إدخالة متأثرة في postIds[] كائن contentIssues اختياري حتى تتمكن من تحديد وإصلاح المشكلة الأساسية:

{
    "postIds": [
        {
            "status": "success",
            "platform": "instagram",
            "id": "17878176260289172",
            "postUrl": "https://www.instagram.com/p/CP1dI9Hp_WO/",
            "contentIssues": {
                "originMediaHostFailed": true,
                "details": ["Media URL could not be retrieved by the social network. Successfully posted using Ayrshare automated media protection."]
            }
        }
    ]
}

إذا رأيت originMediaHostFailed في استجاباتك، فراجع تكوين استضافة الوسائط. راجع زاحف وسائط Meta محظور للأسباب والحلول الشائعة.

المسافات والأحرف الخاصة

نوصي بتجنب ما يلي في عناوين URL للوسائط:

المسافات في عنوان URL.
المسافات المُرمَّزة في عنوان URL.
الأحرف الخاصة في عنوان URL حتى لو كانت مُرمَّزة، مثل علامات التشكيل é.

على سبيل المثال:

https://img.ayrshare.com/012/test .webp

يفشل عنوان URL هذا بسبب المسافة test .webp. لا نوصي أيضًا باستخدام المسافات المُرمَّزة في URL، مثل %20 في عنوان URL - يمكن أن يسبب هذا أيضًا مشاكل مع بعض الشبكات الاجتماعية. وصورة Unsplash هذه:

https://unsplash.com/photos/a-house-in-the-middle-of-a-field-with-trees-in-the-background-znbmh2-cIj0

تفشل صورة Unsplash هذه لأنها لا تصل مباشرة إلى الصورة، ولكنها تعرض تطبيق ويب.

تنقية أسماء الملفات وعناوين URL

يمكنك تنقية أسماء الملفات باستخدام تعبير عادي مثل /[^a-z0-9\/\.]/gi.

const sanitizeFileName = (url) => url.replace(/[^a-z0-9\/\.]/gi, "_");
sanitizeFileName("tést .webp"); // t_st_.webp

أو تنقية عنوان URL

const sanitizeUrl = (url) => {
  const [protocol, rest] = url.split("://");
  const [domain, ...path] = rest.split("/");
  const sanitizedPath = path.join("/").replace(/[^a-z0-9\/\.]/gi, "_");
  return `${protocol}://${domain}/${sanitizedPath}`;
};

// Output: https://img.ayrshare.com/012/t_st_.webp
sanitizeUrl("https://img.ayrshare.com/012/tést .webp");

معلومات إضافية

إذا كنت تستضيف ذاتيًا، فتأكد من أن عنوان URL يمكن الوصول إليه خارجيًا ولا يتطلب أذونات خاصة.
انظر أدناه كيفية التعامل مع مقاطع الفيديو ذات الامتدادات غير المعروفة، غالبًا عناوين URL موقعة مثل AWS S3.
إذا كنت تستخدم عنوان URL موقعًا، مثل S3، فنوصي بتعيين انتهاء صلاحية عنوان URL على 7 أيام على الأقل. هذا يسمح لفريقنا بالمساعدة في أي أسئلة لديك حول نشر المنشور.
اختبر ما إذا كان عنوان URL للوسائط موجودًا باستخدام أدوات التحقق من الوسائط.

سرعة التنزيل

تأكد من أن استضافة الوسائط الخاصة بك لديها اتصال سريع، خاصةً سرعة التنزيل. يمكنك اختبار أداء استضافة الوسائط الخاصة بك على pingdom. نوصي بتقييم B على الأقل.

امتداد الفيديو

إذا لم ينته عنوان URL الخاص بك بامتداد فيديو معروف مثل mp4، فيمكنك استخدام حقل isVideo: true في المنشور لتحديد أن mediaUrl هو فيديو. ستحاول Ayrshare تحديد نوع الملف، مثل MOV. ومع ذلك، نوصي بإنهاء ملف الفيديو الخاص بك بشكل صريح بامتداد معروف، مثل mp4، لأن هذا لديه معدل نجاح أعلى مع الشبكات الاجتماعية.

صورة أو فيديو فقط

تدعم بعض الشبكات الاجتماعية إرسال الوسائط بدون نص المنشور. إذا كنت لا ترغب في تضمين نص المنشور، فأرسل سلسلة فارغة: post: "" الشبكات الاجتماعية التالية تدعم عدم وجود منشور/نص فارغ: Facebook وInstagram وLinkedIn وThreads وTikTok وX/Twitter.

اختبار الصور ومقاطع الفيديو

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

فواصل الأسطر

إذا كنت تريد فواصل الأسطر (أسطر جديدة) في منشور، فاستخدم فاصل السطر غير المرئي \u2063\n. على سبيل المثال، This is a new\u2063\nline.نوصي أيضًا بتجربتها في Postman لمعرفة كيفية ترجمة فاصل السطر الجديد في لغتك المفضلة. على سبيل المثال، غالبًا ما يستخدم PHP فقط \nلا تدعم بعض الشبكات الاجتماعية حاليًا فواصل الأسطر في نص المنشور.

المنشورات والوسائط متعددة المنصات

تتيح لك هذه الميزة تخصيص محتوى منشورك ووسائطك للشبكات الاجتماعية المختلفة في استدعاء واحد لواجهة برمجة التطبيقات. يمكنك تحديد نصوص و/أو صور فريدة لكل منصة باستخدام كائنات لحقول post وmediaUrls.

استخدم بنية كائن لحقول post و/أو mediaUrls.
حدد محتوى خاص بالمنصة باستخدام أسماء المنصات كمفاتيح.
قم بتضمين مفتاح default للمحتوى الذي سيتم استخدامه على المنصات غير المحددة صراحة.

{
  "post": {
    "instagram": "Great IG pic!",
    "facebook": "Great FB pic!",
    "default": "Great default pic!"
  },
  "platforms": ["instagram", "facebook", "linkedin"],
  "mediaUrls": {
    "instagram": "https://img.ayrshare.com/012/gb.jpg",
    "linkedin": "https://img.ayrshare.com/012/gb.jpg",
    "default": "https://img.ayrshare.com/012/gb.jpg"
  }
}

في المثال أعلاه:

سيستخدم Instagram نصه المحدد وعنوان URL للصورة.
سيستخدم Facebook نصه المحدد وعنوان URL للصورة الافتراضية.
سيستخدم LinkedIn النص الافتراضي وعنوان URL للصورة المحدد.

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

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

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

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

منشورات النص المنسق

يمكنك إضافة نص منسق مثل ”𝓗𝓮𝓵𝓵𝓸, how about a little 𝗯𝗼𝗹𝗱 𝘁𝗲𝘅𝘁 and 𝘪𝘵𝘢𝘭𝘪𝘤𝘴 𝘵𝘦𝘹𝘵 and an x₂?”. يمكنك استخدام النص المنسق على شبكات مثل Twitter وFacebook وLinkedIn وTelegram وInstagram. إذا كنت تنشر على Reddit، فيُرجى استخدام تنسيق Markdown بنكهة Reddit. تُستخدم عناصر HTML لتحديد نوع النص المنسق، والذي يُترجم إلى Unicode. على سبيل المثال:

{
    "post": "<var>Hello</var>, how about a little <b>bold text</b> and <i>italics text</i> and an x<sub>2</sub>?"
    "platforms": ["twitter"]
}

عناصر HTML

HTML	مثال
<b>Nice One!</b>	Nice One!
<strong>Hello, world!</strong>	Hello, world!
<em>World</em>	World
normal <i>italics <b>bold italics</b></i>	normal italics bold italics
`<b>Hello</b>, world!`	`Hello, world!`
`<b>Hello</b>, world!`	`Hello``, world!`
<samp>123</samp>	𝟷𝟸𝟹
<var>Hello</var>	𝓗𝓮𝓵𝓵𝓸
x<sub>2</sub>	x₂
x<sup>2</sup>	x²

رموز CSS

الرمز	مثال	النتيجة
\u00B0	It’s 25\u00B0C today!	It’s 25°C today!
\u2063\n	This is a new\u2063\nline.	This is a new line.

جدولة المنشورات

إنشاء منشورات مجدولة

يمكنك جدولة المنشورات المستقبلية عن طريق تحديد المعلمة scheduleDate بتنسيق التاريخ والوقت في Zulu/UTC. Zulu Time، والمعروف أيضًا باسم التوقيت العالمي المنسق (UTC)، هو المعيار العالمي للوقت. على سبيل المثال، استخدم التنسيق YYYY-MM-DDThh:mm:ssZ وأرسل كـ 2026-07-08T12:30:00Z. يرجى مراجعة utctime لمزيد من الأمثلة.

{
  "post": "Hello, world!",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["facebook", "instagram"],
  "scheduleDate": "2023-07-08T12:30:00Z"
}

يرجى مراجعة https://www.utctime.net/ حول كيفية تحويل وقتك المحلي إلى وقت Zulu/UTC. إذا كان التاريخ والوقت المجدولان في الماضي، فسيتم إرسال المنشور فورًا.

إذا تم تضمين mediaUrl مع منشور مجدول، فيجب أن تكون الوسائط متاحة في وقت النشر المجدول. على سبيل المثال، إذا كان المنشور مجدولًا للنشر في 5 مارس 2026، فيجب أن تكون الوسائط متاحة في 5 مارس 2026.

التعامل مع الأخطاء للمنشورات المجدولة مقابل الفوريةهناك اختلاف مهم في كيفية التعامل مع أخطاء التحقق بين المنشورات الفورية والمجدولة:

المنشورات الفورية
- عند النشر فورًا (بدون scheduleDate)، إذا فشلت منصة واحدة في اجتياز فحوصات التحقق، فسيستمر معالجة المنصات الأخرى. على سبيل المثال، إذا تجاوز منشور حد الأحرف في Twitter ولكنه صالح لـ Facebook وInstagram، فسيفشل المنشور على Twitter ولكنه سيظل يُنشر على Facebook وInstagram.
المنشورات المجدولة
- عند جدولة المنشورات للنشر المستقبلي (مع scheduleDate)، يجب أن تجتاز جميع المنصات فحوصات التحقق الأولية قبل جدولة المنشور. إذا فشلت أي منصة في فحوصات التحقق الأولية، فسيتم رفض عملية الجدولة بأكملها وسيتم إرجاع خطأ فورًا.
- ومع ذلك، قد لا يتم اكتشاف بعض الأخطاء الخاصة بالمنصة حتى وقت النشر الفعلي. في هذه الحالات، سيحاول المنشور المجدول النشر على جميع المنصات، وسيتم الإبلاغ عن إخفاقات المنصات الفردية في النتائج النهائية دون التأثير على المنصات الأخرى.

التحقق من حالة منشور مجدول

يمكنك التحقق من حالة منشور مجدول بعدة طرق:

قم بإعداد إجراء ويب هوك المجدول لتلقي تلقائيًا حالة المنشور المجدول. هذا متاح لخطة Business وهو الطريقة الموصى بها.
احصل على حالة منشور مجدول باستخدام استدعاء GET مع معرف المنشور.
تحقق من الحالة في لوحة تحكم Ayrshare. قم أولاً بالتبديل إلى ملف المستخدم الذي تم نشر المنشور تحته، ثم انتقل إلى صفحة “Posts” وابحث باستخدام معرف منشور Ayrshare.

إيقاف المنشورات المجدولة مؤقتًا

يمكنك إيقاف المنشورات المجدولة التي لم يتم نشرها بعد مؤقتًا. إيقاف منشور مجدول مؤقتًا سيمنع نشره حتى يتم إلغاء إيقافه المؤقت. استخدم استدعاء PATCH لإيقاف أو إلغاء إيقاف المنشور المجدول مؤقتًا. يُرجى ملاحظة أنه إذا تم إلغاء إيقاف منشور مؤقتًا وكان scheduleDate في الماضي، فسيتم نشر المنشور فورًا. فكر في تحديث scheduleDate قبل إلغاء الإيقاف المؤقت.

اختصار الروابط

يمكن اختصار الروابط في منشور باستخدام مختصر الروابط من Ayrshare. يمكنك تشغيل الاختصار التلقائي للروابط باستخدام معلمة shortenLinks عند إرسال منشور. Max Pack مطلوب.

{
  "post": "Hello, world with a link https://www.ayrshare.com",
  "platforms": ["linkedin"],
  "shortenLinks": true
}

صور Unsplash

الحقول التالية متاحة لمعلمة نص unsplash:

صورة عشوائية: random يُرجع صورة Unsplash عشوائية.
صورة تعتمد على البحث: قيمة سلسلة كمصطلح بحث؛ على سبيل المثال، money ستحدد صورة عشوائية بناءً على money.
معرفات الصور: قيمة مصفوفة من المعرفات؛ على سبيل المثال، [“HubtZZb2fCM”] لصورة https://unsplash.com/photos/HubtZZb2fCM

{
  "post": "Hello, world!",
  "platforms": ["instagram"],
  "unsplash": "random",
  "unsplash": "search term", // unsplash: "money"
  "unsplash": ["unsplash image ID"] // unsplash: ["HubtZZb2fCM"]
}

إذا كنت تنسخ عنوان URL لـ Unsplash للنشر في mediaUrls، فيرجى التأكد من نسخ عنوان الصورة و ليس فقط عنوان URL. يرجى مراجعة هذا المثال لمزيد من المعلومات.

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

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

سير عمل الموافقة

مثال على سير عمل الموافقة

فيديو سير عمل الموافقة

الهاشتاغات التلقائية

إعادة النشر التلقائي

التعليق الأول

وقت معالجة التعليق الأول

المنشورات المتساوية القوة

متطلبات الصور والفيديو

إرشادات الصور والفيديو

عنوان URL صالح

حماية الوسائط الآلية

المسافات والأحرف الخاصة

تنقية أسماء الملفات وعناوين URL

معلومات إضافية

سرعة التنزيل

امتداد الفيديو

صورة أو فيديو فقط

اختبار الصور ومقاطع الفيديو

فواصل الأسطر

المنشورات والوسائط متعددة المنصات

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

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

منشورات النص المنسق

عناصر HTML

رموز CSS

جدولة المنشورات

إنشاء منشورات مجدولة

التحقق من حالة منشور مجدول

إيقاف المنشورات المجدولة مؤقتًا

اختصار الروابط

صور Unsplash

​سير عمل الموافقة

​مثال على سير عمل الموافقة

​فيديو سير عمل الموافقة

​الهاشتاغات التلقائية

​إعادة النشر التلقائي

​التعليق الأول

​وقت معالجة التعليق الأول

​المنشورات المتساوية القوة

​متطلبات الصور والفيديو

إرشادات الصور والفيديو

​عنوان URL صالح

​حماية الوسائط الآلية

​المسافات والأحرف الخاصة

​تنقية أسماء الملفات وعناوين URL

​معلومات إضافية

​سرعة التنزيل

​امتداد الفيديو

​صورة أو فيديو فقط

​اختبار الصور ومقاطع الفيديو

​فواصل الأسطر

​المنشورات والوسائط متعددة المنصات

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

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

​منشورات النص المنسق

​عناصر HTML

​رموز CSS

​جدولة المنشورات

​إنشاء منشورات مجدولة

​التحقق من حالة منشور مجدول

​إيقاف المنشورات المجدولة مؤقتًا

​اختصار الروابط

​صور Unsplash

سير عمل الموافقة

مثال على سير عمل الموافقة

فيديو سير عمل الموافقة

الهاشتاغات التلقائية

إعادة النشر التلقائي

التعليق الأول

وقت معالجة التعليق الأول

المنشورات المتساوية القوة

متطلبات الصور والفيديو

عنوان URL صالح

حماية الوسائط الآلية

المسافات والأحرف الخاصة

تنقية أسماء الملفات وعناوين URL

معلومات إضافية

سرعة التنزيل

امتداد الفيديو

صورة أو فيديو فقط

اختبار الصور ومقاطع الفيديو

فواصل الأسطر

المنشورات والوسائط متعددة المنصات

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

منشورات النص المنسق

عناصر HTML

رموز CSS

جدولة المنشورات

إنشاء منشورات مجدولة

التحقق من حالة منشور مجدول

إيقاف المنشورات المجدولة مؤقتًا

اختصار الروابط

صور Unsplash