مفاتيح 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
نص بديل للصور للمساعدة في إمكانية الوصول وقارئات الشاشة. الحد الأقصى 1,000 حرف لكل نص بديل.راجع النص البديل لمزيد من المعلومات.
تقييد الوسائط لبلدان معينة بحظر مناطق معينة. استخدم رموز البلدان.لا يمكن استخدامه مع
allowCountries. راجع القيود الجغرافية لمزيد من المعلومات.تقييد الوسائط لبلدان معينة بالسماح لمناطق معينة. استخدم رموز البلدان.لا يمكن استخدامه مع
blockCountries. راجع القيود الجغرافية لمزيد من المعلومات.تفعيل نشر المنشورات الطويلة حتى 25,000 حرف لمستخدمي Premium.راجع المنشور الطويل لمزيد من المعلومات.
السماح بنشر مقاطع فيديو أطول من دقيقتين و20 ثانية للحسابات المعتمدة.راجع الفيديو الطويل لمزيد من المعلومات.
إجراء استطلاعات رأي مع خيارات مخصصة ومدة محددة.الحقول المطلوبة:
duration (رقم بالدقائق)، options (مصفوفة من السلاسل).راجع الاستطلاعات لمزيد من المعلومات.اقتبس تغريدة أخرى بتحديد معرف التغريدة.راجع اقتباس التغريدة لمزيد من المعلومات.
التحكم فيمن يمكنه الرد على المنشور.القيم:
following, mentioned, subscribers, أو verified.راجع إعدادات الرد لمزيد من المعلومات.جعل المنشور مرئيًا للمشتركين فقط.راجع للمشتركين فقط لمزيد من المعلومات.
إضافة ترجمات/تعليقات إلى مقاطع الفيديو باستخدام ملفات SRT. يجب أن يكون عنوان URL صالحًا لملف SRT ينتهي بـ
.srt.راجع الترجمات / التعليقات لمقاطع الفيديو لمزيد من المعلومات.اسم مسار التعليق. الحد الأقصى 150 حرفًا.
تعيين صورة مصغرة (صورة غلاف) لمقاطع الفيديو. يجب أن يكون عنوان URL يشير إلى ملف صورة JPEG أو PNG أو BMP أو WebP.راجع الصورة المصغرة للفيديو لمزيد من المعلومات وإرشادات وسائط X لمتطلبات الصورة.
تعيين عنوان لفيديو. يتم تعيينه إلى حقل العنوان في X Media Studio.راجع بيانات وصف الفيديو لمزيد من المعلومات.
تعيين وصف لفيديو. يتم تعيينه إلى حقل الوصف في X Media Studio.راجع بيانات وصف الفيديو لمزيد من المعلومات.
تقسيم المنشورات الطويلة إلى سلاسل thread متصلة مع ترقيم ووسائط اختيارية.راجع Threads لمزيد من المعلومات.
إضافة أرقام تلقائيًا في نهاية الـ threads بتنسيق 1/n.يتطلب
thread: true.إضافة كائنات وسائط إلى الـ threads. سيتم إضافة كائن وسائط واحد إلى كل thread بالترتيب.استخدم
null لتخطي الوسائط لـ thread معين. استخدم كائنات مع عناوين URL متعددة لعدة وسائط لكل thread.النص البديل
أضف نصًا بديلًا، يُعرف أيضًا بـ alt text، إلى صورة تغريدة. النص البديل في X هو ميزة إمكانية الوصول المستخدمة لمعلومات المستخدم الإضافية وقارئات الشاشة. استخدمaltText في كائن twitterOptions.
X Alt Text
mediaUrls. سيتم تطبيق النص البديل على كل صورة بالترتيب.
لا يمكن تطبيق النص البديل على مقاطع الفيديو. إذا تم تضمين فيديو في
mediaUrls مع altText,
فلن يتم نشر الفيديو. يجب أن يكون النص البديل 1,000 حرف أو أقل.القيود الجغرافية
يمكنك تقييد وسائط X، مثل صورة أو فيديو، لبلدان معينة باستخدام المعاملينblockCountries و allowCountries مع رموز البلدان.
سيظل المنشور يظهر في جميع البلدان، ولكن لن تكون الوسائط متاحة في البلدان المحددة.
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
code: 111.
الفيديو الطويل
يتطلب Business أو Enterprise Plan. تتطلب X أن يكون لمقاطع الفيديو حد أقصى لطول الفيديو قدره دقيقتان و20 ثانية. ومع ذلك، إذا تم اعتمادك من قِبل X لتحميل مقاطع فيديو أطول، مثل إذا كان حساب X الخاص بالمستخدم حساب Premium أو في برنامج Amplify Partner، يمكنك نشر مقاطع فيديو تصل إلى 10+ دقائق. استخدم معامل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) والتي تسمح لك بمشاركة أفكار أطول تتجاوز حد أحرف المنشور الواحد، وتظهر كسرد متواصل عند عرضها معًا.
نشر 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 بالترتيب.
"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
فواصل Thread
تقوم Ayrshare تلقائيًا بتقسيم نص المنشور إلى تغريدات بطول مناسب (> 280 حرفًا). عند إنشاء threads، نعطي الأولوية للحفاظ على الجمل الكاملة في منشور واحد كلما أمكن. إذا كانت الجملة لا تناسب، نقوم بالتقسيم بين الجمل. للجمل الطويلة جدًا، نقوم بالتقسيم بين الكلمات. في الحالات النادرة التي تكون فيها الكلمة طويلة جدًا، نقوم بتقسيم الكلمة نفسها. يمكنك أيضًا إضافة فقرات يدويًا باستخدام\n\n إلى نص المنشور للإشارة إلى ضرورة إنشاء thread فريد.
إذا كان لديك \n\n في نص المنشور، فلن نقوم تلقائيًا بتقسيم المنشور إلى threads.
على سبيل المثال:
Example X Thread
\u2063\n\u2063\n
X Thread with Paragraphs
حذف 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.

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