X API

​

مفاتيح X BYO API

​

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

{
  "post": "The best Tweet ever #best https://www.twitter.com", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["twitter"]
}

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

​

خيارات X

{
  "twitterOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"],
    "blockCountries": ["US", "CA"], // or "allowCountries": ["GB", "IE"]
    "longPost": true,
    "longVideo": true,
    "poll": {
      "duration": 5, // required. Number in minutes
      "options": ["yes", "maybe", "no"] // required
    },
    "quoteTweetId": "651601430669664256",
    "replySettings": "mentioned",
    "subscribersOnly": true,
    "isAIGenerated": true,
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg",

    // Video Metadata
    "videoTitle": "My Product Demo",
    "videoDescription": "A short walkthrough of our latest release.",

    // Subtitles / Captions for Videos
    "subTitleUrl": "https://img.ayrshare.com/012/captions.srt",
    "subTitleLanguage": "en",
    "subTitleName": "English",

    // Thread Options
    "thread": true,
    "threadNumber": true,
    "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  }
}

​

النص البديل

{
  "twitterOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts
  }
}

​

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

{
  "twitterOptions": {
    "blockCountries": ["US", "CA"]
  }
}

{
  "twitterOptions": {
    "allowCountries": ["GB", "IE"]
  }
}

• blockCountries: مصفوفة من رموز البلدان لحظرها. راجع رموز البلدان.
• allowCountries: مصفوفة من رموز البلدان للسماح بها. راجع رموز البلدان.

​

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

{
  "twitterOptions": {
    "longPost": true
  }
}

​

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

{
  "twitterOptions": {
    "longVideo": true
  }
}

​

الإشارات

{
  "post": "The best social media API @Ayrshare ever!",
  "platforms": ["twitter"]
}

​

الاستطلاعات

{
  "twitterOptions": {
    "poll": {
      "duration": 5, // required. Number in minutes
      "options": ["yes", "maybe", "no"] // required
    }
  }
}

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

​

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

{
  "twitterOptions": {
    "quoteTweetId": "651601430669664256" // low-level Tweet Id
  }
}

​

إعدادات الرد

{
  "twitterOptions": {
    "replySettings": "mentioned"
  }
}

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

​

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

{
  "twitterOptions": {
    "subscribersOnly": true
  }
}

​

Made with AI

{
  "twitterOptions": {
    "isAIGenerated": true
  }
}

​

Accepted Values

​

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

{
  "twitterOptions": {
    "subTitleUrl": "https://img.ayrshare.com/012/captions.srt",
    "subTitleLanguage": "en",
    "subTitleName": "English"
  }
}

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

​

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

{
  "twitterOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}

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

​

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

{
  "twitterOptions": {
    "videoTitle": "My Product Demo",
    "videoDescription": "A short walkthrough of our latest release."
  }
}

• videoTitle: عنوان الفيديو، معيَّن إلى حقل العنوان في X Media Studio.
• videoDescription: وصف الفيديو، معيَّن إلى حقل الوصف في X Media Studio.

​

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

​

Thread

​

نشر Thread

{
    "twitterOptions": {
        "thread": true,        // required for TweetStorm
        "threadNumber": true,  // optional to add numbers to each thread
        "mediaUrls": ["https://site.com/image1.png", "https://site.com/image2.png", ...]  // optional one media object is added to a thread in order
    }
}

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

​

أي خيارات twitterOptions تنطبق على Thread

• المنشور الأول فقط — poll وquoteTweetId وreplyId وreplySettings. ينتمي الاستطلاع أو الاقتباس إلى المنشور الذي يفتتح الـ thread، ولا تقبل X إعدادات الرد إلا على المنشور الذي يبدأ المحادثة، لذلك يُرفض إرسالها على رد. تعيين replySettings على thread يقيّد الردود للمحادثة بأكملها اعتبارًا من ذلك المنشور الأول.
• لا يمكن الجمع بين replySettings وreplyId. لا تقبل X إعدادات الرد على منشور هو نفسه رد، لذلك لا يمكن لـ thread يُنشر كرد على منشور موجود أن يعيّن أيضًا replySettings — يُرفض الطلب ولا يُنشر أي شيء. وهذا هو القيد نفسه الذي كان دائمًا على الرد الواحد. أرسل أحدهما دون الآخر.
• كل منشور — كل شيء آخر، بما في ذلك subscribersOnly وlongVideo وخيارات Pro Media. ينطبق subscribersOnly على كل منشور حتى لا تكون المنشورات اللاحقة في thread حصري عامة.
• خاص بالوسائط — ينطبق altText والترجمات على وسائط المنشور الأول. تُنشر وسائط المنشورات اللاحقة بدونها.

​

وسائط Thread

تخطي الوسائط

وسائط متعددة

{
  "twitterOptions": {
    "thread": true,
    "threadNumber": true,
    "mediaUrls": [
      "https://img.ayrshare.com/random/photo-1.jpg",
      {
        "1": "https://img.ayrshare.com/random/photo-2.jpg",
        "2": "https://img.ayrshare.com/random/photo-3.jpg"
      },
      "https://img.ayrshare.com/random/photo-4.jpg"
    ]
  }
}

​

فواصل Thread

{
  "post": "This is tweet 1\n\nThis is tweet 2.",
  "platforms": ["twitter"],
  "twitterOptions": {
    "thread": true
  }
}

{
  "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.",
  "platforms": ["twitter"],
  "twitterOptions": {
    "thread": true
  }
}

​

حذف Thread

​

حدود الأحرف

​

توافق فيديو X

​

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

{
  "twitterOptions": {
    "subscribersOnly": true
  }
}

​

إعدادات الرد

{
  "twitterOptions": {
    "replySettings": "mentioned"
  }
}

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