الانتقال إلى المحتوى الرئيسي

مفاتيح X BYO API

اعتبارًا من 31 مارس 2026، تتطلب جميع عمليات X/Twitter استخدام بيانات اعتماد API الخاصة بك. بعد ربط حساب X الخاص بك عبر OAuth، قم بتضمين هذين الرأسين في كل طلب يستهدف X:لم تقم بالربط بعد؟ راجع دليل إعداد X BYO Key لربط حساب X الخاص بك.
لم تعد Ayrshare تفرض حدود معدلها الشهرية أو اليومية الخاصة على X/Twitter. نظرًا لأن طلبات X تستخدم بيانات الاعتماد الخاصة بك (BYO)، فإن استخدامك يخضع فقط لحدود تطبيق X Developer الخاص بك. راجع توثيق حدود معدل X API للحصول على التفاصيل.

النشر على X (Twitter)

JSON لمنشور أساسي مع رابط وصورة باستخدام X API، المعروف سابقًا باسم Twitter API:
X Post
  • ستقوم X تلقائيًا بمعاينة الرابط في التغريدة ما لم تتضمن صورة أو فيديو. في المثال أعلاه، ستظهر الصورة. ستؤدي إزالة الصورة إلى ظهور معاينة الرابط.
  • إذا لم ينتهِ الفيديو الخاص بك بامتداد فيديو معروف مثل mp4، فيرجى استخدام المعامل isVideo. راجع نقطة النهاية /post للحصول على التفاصيل.
  • تدعم X أيضًا إرسال الوسائط بدون نص منشور. إذا كنت لا تريد تضمين نص المنشور، أرسل سلسلة فارغة post: "".
  • يمكنك تحميل ما يصل إلى 4 صور أو مقاطع فيديو في تغريدة واحدة. يرجى الاطلاع على الإرشادات والقيود المهمة الخاصة بـنشر مقاطع فيديو Twitter.
  • راجع إرشادات وسائط X وترخيص X لمزيد من المعلومات.

خيارات X

يمكنك تعيين خيارات إضافية للمنشور باستخدام المعامل twitterOptions.
X Options
خيارات X هي حقول اختيارية يمكن استخدامها للتحكم في المنشور.
altText
array of strings
نص بديل للصور للمساعدة في إمكانية الوصول وقارئات الشاشة. الحد الأقصى 1,000 حرف لكل نص بديل.راجع النص البديل لمزيد من المعلومات.
blockCountries
array of strings
تقييد الوسائط لبلدان معينة بحظر مناطق معينة. استخدم رموز البلدان.لا يمكن استخدامه مع allowCountries. راجع القيود الجغرافية لمزيد من المعلومات.
allowCountries
array of strings
تقييد الوسائط لبلدان معينة بالسماح لمناطق معينة. استخدم رموز البلدان.لا يمكن استخدامه مع blockCountries. راجع القيود الجغرافية لمزيد من المعلومات.
longPost
boolean
افتراضي:false
تفعيل نشر المنشورات الطويلة حتى 25,000 حرف لمستخدمي Premium.راجع المنشور الطويل لمزيد من المعلومات.
longVideo
boolean
افتراضي:false
السماح بنشر مقاطع فيديو أطول من دقيقتين و20 ثانية للحسابات المعتمدة.راجع الفيديو الطويل لمزيد من المعلومات.
poll
object
إجراء استطلاعات رأي مع خيارات مخصصة ومدة محددة.الحقول المطلوبة: duration (رقم بالدقائق)، options (مصفوفة من السلاسل).راجع الاستطلاعات لمزيد من المعلومات.
quoteTweetId
string
اقتبس تغريدة أخرى بتحديد معرف التغريدة.راجع اقتباس التغريدة لمزيد من المعلومات.
replySettings
string
التحكم فيمن يمكنه الرد على المنشور.القيم: following, mentioned, subscribers, أو verified.راجع إعدادات الرد لمزيد من المعلومات.
subscribersOnly
boolean
افتراضي:false
جعل المنشور مرئيًا للمشتركين فقط.راجع للمشتركين فقط لمزيد من المعلومات.
subTitleUrl
string
إضافة ترجمات/تعليقات إلى مقاطع الفيديو باستخدام ملفات SRT. يجب أن يكون عنوان URL صالحًا لملف SRT ينتهي بـ .srt.راجع الترجمات / التعليقات لمقاطع الفيديو لمزيد من المعلومات.
subTitleLanguage
string
افتراضي:"en"
لغة الترجمات. يجب أن تكون رمز لغة صالحًا.
subTitleName
string
اسم مسار التعليق. الحد الأقصى 150 حرفًا.
thumbNail
string
تعيين صورة مصغرة (صورة غلاف) لمقاطع الفيديو. يجب أن يكون عنوان URL يشير إلى ملف صورة JPEG أو PNG أو BMP أو WebP.راجع الصورة المصغرة للفيديو لمزيد من المعلومات وإرشادات وسائط X لمتطلبات الصورة.
videoTitle
string
تعيين عنوان لفيديو. يتم تعيينه إلى حقل العنوان في X Media Studio.راجع بيانات وصف الفيديو لمزيد من المعلومات.
videoDescription
string
تعيين وصف لفيديو. يتم تعيينه إلى حقل الوصف في X Media Studio.راجع بيانات وصف الفيديو لمزيد من المعلومات.
thread
boolean
افتراضي:false
تقسيم المنشورات الطويلة إلى سلاسل thread متصلة مع ترقيم ووسائط اختيارية.راجع Threads لمزيد من المعلومات.
threadNumber
boolean
افتراضي:false
إضافة أرقام تلقائيًا في نهاية الـ threads بتنسيق 1/n.يتطلب thread: true.
mediaUrls
array of strings
إضافة كائنات وسائط إلى الـ threads. سيتم إضافة كائن وسائط واحد إلى كل thread بالترتيب.استخدم null لتخطي الوسائط لـ thread معين. استخدم كائنات مع عناوين URL متعددة لعدة وسائط لكل thread.

النص البديل

أضف نصًا بديلًا، يُعرف أيضًا بـ alt text، إلى صورة تغريدة. النص البديل في X هو ميزة إمكانية الوصول المستخدمة لمعلومات المستخدم الإضافية وقارئات الشاشة. استخدم altText في كائن twitterOptions.
X Alt Text
يجب أن يتوافق كل نص بديل مع صورة في مصفوفة mediaUrls. سيتم تطبيق النص البديل على كل صورة بالترتيب.
لا يمكن تطبيق النص البديل على مقاطع الفيديو. إذا تم تضمين فيديو في mediaUrls مع altText, فلن يتم نشر الفيديو. يجب أن يكون النص البديل 1,000 حرف أو أقل.

القيود الجغرافية

يمكنك تقييد وسائط X، مثل صورة أو فيديو، لبلدان معينة باستخدام المعاملين blockCountries و allowCountries مع رموز البلدان. سيظل المنشور يظهر في جميع البلدان، ولكن لن تكون الوسائط متاحة في البلدان المحددة.
يجب استخدام أحد المعاملين blockCountries أو allowCountries فقط في المرة الواحدة. إذا تم استخدام كلا المعاملين أو لم تدعم X بلدًا معينًا، فسيتم تجاهل القيود الجغرافية.

المنشور الطويل

يتمتع المستخدمون الذين لديهم حسابات X Premium، مثل Premium أو Premium Plus، بالقدرة على نشر منشورات أطول تصل إلى 25,000 حرف. تسمح Ayrshare تلقائيًا بالمنشورات الطويلة للمستخدمين الذين لديهم حسابات X Premium. إذا قام المستخدم بتغيير حالة X Premium الخاصة به، يرجى الانتظار 24 ساعة حتى ينعكس ذلك في Ayrshare. يمكنك التحقق من حالة اشتراك Premium للمستخدم باستخدام نقاط النهاية /user أو /analytics. يمكنك أيضًا فرض قبول منشور طويل باستخدام معامل الجسم longPost. يمكن القيام بذلك عبر تضمين JSON التالي في طلبك:
X Long Post
ومع ذلك، إذا حاول مستخدم بدون حساب Premium نشر تغريدة طويلة، فسيقوم النظام بإرجاع خطأ code: 111.

الفيديو الطويل

يتطلب Business أو Enterprise Plan. تتطلب X أن يكون لمقاطع الفيديو حد أقصى لطول الفيديو قدره دقيقتان و20 ثانية. ومع ذلك، إذا تم اعتمادك من قِبل X لتحميل مقاطع فيديو أطول، مثل إذا كان حساب X الخاص بالمستخدم حساب Premium أو في برنامج Amplify Partner، يمكنك نشر مقاطع فيديو تصل إلى 10+ دقائق.
يرجى التحقق من أن حساب X الخاص بالمستخدم هو Premium أو في برنامج Amplify Partner قبل استخدام معامل longVideo. إذا لم يكن حساب X الخاص بالمستخدم مصرحًا له بنشر مقاطع فيديو طويلة، فسيقوم النظام بإرجاع خطأ.
استخدم معامل longVideo في twitterOptions عند نشر فيديو طويل:
X Long Video

الإشارات

اذكر مقبض X آخر بإضافة @handle في نص المنشور. على سبيل المثال:
X Mention
يرجى مراجعة القواعد المهمة بشأن الإشارات.

الاستطلاعات

قم بإجراء استطلاع X باستخدام معامل poll في twitterOptions.
X Poll
  • duration: عدد الدقائق التي يحدد فيها مدة إجراء الاستطلاع.
  • options: مصفوفة من السلاسل تحتوي على خيارات الاستطلاع.

اقتباس التغريدة

يمكنك اقتباس تغريدة أخرى بتحديد معرّف التغريدة منخفض المستوى. يمكن استرداد المعرّف عبر استجابة /post في حقل postIds، أو الحصول على السجل، أو مباشرة من عنوان URL للتغريدة: https://twitter.com/Ayrshare/status/1651601430669664256
X Quote Tweet

إعدادات الرد

يمكنك تعيين إعدادات الرد لمنشور للسماح بالردود فقط من قِبل أنواع معينة من المستخدمين.
X Reply Settings
يمكن أن يكون معامل replySettings واحدًا من القيم التالية:
  • following: يمكن فقط للمستخدمين الذين يتابعهم حساب X الرد.
  • mentioned: يمكن فقط للمستخدمين المذكورين في المنشور الرد.
  • subscribers: يمكن فقط للمستخدمين المشتركين في حساب X الذي نشر المنشور الرد.
  • verified: يمكن فقط للمستخدمين المُحقَّق منهم على X الرد على المنشور.

للمشتركين فقط

يمكنك تعيين منشور ليكون مرئيًا للمشتركين فقط باستخدام معامل subscribersOnly.
X Subscribers Only

الترجمات / التعليقات لمقاطع الفيديو

يمكنك إضافة ترجمات X، المعروفة أيضًا باسم تعليقات X، إلى مقاطع الفيديو بتضمين ملف SRT. استخدم حقل subTitleUrl في كائن twitterOptions لتحديد عنوان URL لملف SRT الخاص بك.
X Subtitles
  • subTitleUrl: ملف SRT صالح. يجب أن يبدأ عنوان URL بـ https:// وينتهي بـ .srt وأن يكون ملف SRT صالحًا.
  • subTitleLanguage: اختياري: لغة الترجمات. يجب أن يكون رمز لغة صالحًا. الافتراضي: “en”.
  • subTitleName: اختياري: اسم مسار التعليق. الاسم مخصص ليكون مرئيًا للمستخدم كخيار أثناء التشغيل. الحد الأقصى المدعوم لطول الاسم هو 150 حرفًا. الافتراضي: “English”.

الصورة المصغرة للفيديو

تعيين صورة مصغرة (صورة غلاف) لمقاطع فيديو Twitter/X. يتم عرض الصورة المصغرة قبل تشغيل الفيديو وتساعد المستخدمين على فهم محتوى الفيديو. استخدم thumbNail في كائن twitterOptions.
Twitter/X Video Thumbnail
  • “thumbNail”: عنوان URL يشير إلى صورة الصورة المصغرة. تنسيقات الصور المدعومة هي JPEG وPNG وBMP وWebP.
  • يجب أن تمثل الصورة المصغرة محتوى الفيديو وأن تكون جذابة بصريًا لتشجيع التفاعل.
  • راجع إرشادات وسائط X لمتطلبات الصورة.

بيانات وصف الفيديو

قم بتعيين عنوان ووصف لفيديو منشور على X. يتم تعيينهما إلى حقلي العنوان والوصف في X Media Studio. استخدم حقلي videoTitle و videoDescription في كائن twitterOptions.
X Video Metadata
  • videoTitle: عنوان الفيديو، معيَّن إلى حقل العنوان في X Media Studio.
  • videoDescription: وصف الفيديو، معيَّن إلى حقل الوصف في X Media Studio.

تحقيق الدخل من الفيديو (Pro Media)

تدعم Ayrshare تحقيق الدخل من فيديو X (Twitter) للحسابات المؤهلة عبر برنامج X’s Pro Media. هذه إمكانية محدودة الوصول — تواصل معنا إذا كنت ترغب في الوصول.

Thread

Thread X، المعروف أيضًا باسم tweetstorm، هو سلسلة متصلة من المنشورات على X (المعروفة سابقًا باسم Twitter) والتي تسمح لك بمشاركة أفكار أطول تتجاوز حد أحرف المنشور الواحد، وتظهر كسرد متواصل عند عرضها معًا. X Thread

نشر Thread

يمكن نشر X Thread عبر API. الـ thread هو منشور مقسم إلى مجموعة من ردود threads ومرتبط في X بخط. يمكنك إما تقسيم المنشور تلقائيًا أو تحديد فواصل thread في نص المنشور.
X Thread
  • thread: true لتقسيم نص المنشور تلقائيًا إلى threads بناءً على فواصل الأسطر.
  • threadNumber: true لإضافة أرقام تلقائيًا في نهاية الـ threads بتنسيق 1/n. على سبيل المثال سيتم إلحاق: 2/5 بالـ thread الثاني من أصل 5.
  • mediaUrls: [array of urls] لإضافة كل كائن وسائط، صورة أو فيديو، إلى thread بالترتيب. سيتم إضافة كائن وسائط واحد فقط إلى thread بالترتيب.
إذا تم إرسال المنشور كـ X Thread، فستكون تحليلات المنشور المرجعة عبارة عن مصفوفة من التغريدات، "twitter": []. راجع استجابة تحليلات المنشور 200 لمزيد من المعلومات.

وسائط Thread

تخطي الوسائط
تخطي الوسائط لـ thread باستخدام null في المصفوفة. على سبيل المثال: ["https://site.com/image1.png", null, "https://site.com/image2.png"] سيؤدي ذلك إلى وضع image1 في التغريدة الأولى، ولا صورة في التغريدة الثانية، و image2 في التغريدة الثالثة.
وسائط متعددة
يمكن إضافة كائنات وسائط متعددة إلى تغريدة في Thread عبر إضافة كائن {} مع عناوين URL للوسائط في مصفوفة mediaUrls. يمكن استخدام أي مفاتيح كائن فريدة. على سبيل المثال:
X Thread with Multiple Media URLs
في هذا المثال، ستحتوي التغريدة الأولى على photo-1.jpg، والتغريدة الثانية على photo-2.jpg و photo-3.jpg، والتغريدة الثالثة على photo-4.jpg.

فواصل Thread

تقوم Ayrshare تلقائيًا بتقسيم نص المنشور إلى تغريدات بطول مناسب (> 280 حرفًا). عند إنشاء threads، نعطي الأولوية للحفاظ على الجمل الكاملة في منشور واحد كلما أمكن. إذا كانت الجملة لا تناسب، نقوم بالتقسيم بين الجمل. للجمل الطويلة جدًا، نقوم بالتقسيم بين الكلمات. في الحالات النادرة التي تكون فيها الكلمة طويلة جدًا، نقوم بتقسيم الكلمة نفسها. يمكنك أيضًا إضافة فقرات يدويًا باستخدام \n\n إلى نص المنشور للإشارة إلى ضرورة إنشاء thread فريد. إذا كان لديك \n\n في نص المنشور، فلن نقوم تلقائيًا بتقسيم المنشور إلى threads. على سبيل المثال:
Example X Thread
سينتج عنه تغريدتان في الـ thread. إذا كنت تريد إضافة فقرات، ولكن دون التقسيم إلى تغريدات، استخدم \u2063\n\u2063\n
X Thread with Paragraphs
سينتج عنه تغريدة واحدة بفقرتين لأن المنشور أقل من 280 حرفًا.

حذف Thread

لحذف Tweet Storm، اتصل بـ نقطة نهاية /post delete مع معرف المنشور من المستوى الأعلى المرجع في الاستجابة. سيتم حذف جميع الـ threads.

حدود الأحرف

يرجى الاطلاع على حدود أحرف X/Twitter لمزيد من المعلومات.

توافق فيديو X

تنشئ بعض برامج الفيديو ملفات MP4 غير متوافقة مع X. على سبيل المثال، تنشئ إصدارات Camtasia الأقدم من 2019.0.9 ملفات MP4 ترفضها X. أيضًا، غالبًا ما يسبب أكثر من مسار صوتي واحد مشاكل. إذا تلقيت الرسالة التالية أثناء النشر، فهذا يشير إلى أن الفيديو غير متوافق مع Twitter ويحتاج إلى إعادة الترميز. "file is currently unsupported" يرجى التحقق من برنامج الفيديو الخاص بك للتوافق. على سبيل المثال، لدى Adobe Media Encoder إعداد تصدير مسبق لـ Twitter 1080p Full HD. Adobe Media Encoder يرجى الاطلاع هنا للحصول على المزيد من أمثلة X API.

للمشتركين فقط

يمكنك تعيين منشور ليكون مرئيًا للمشتركين فقط باستخدام معامل subscribersOnly.
X Subscribers Only

إعدادات الرد

يمكنك تعيين إعدادات الرد لمنشور للسماح بالردود فقط من قِبل أنواع معينة من المستخدمين.
X Reply Settings
يمكن أن يكون معامل replySettings واحدًا من القيم التالية:
  • following: يمكن فقط للمستخدمين الذين يتابعهم حساب X الرد.
  • mentioned: يمكن فقط للمستخدمين المذكورين في المنشور الرد.
  • subscribers: يمكن فقط للمستخدمين المشتركين في حساب X الذي نشر المنشور الرد.
  • verified: يمكن فقط للمستخدمين المُحقَّق منهم على X الرد على المنشور.