TwitterDown API v1

نظرة عامة

توفر TwitterDown API وصولاً برمجياً لاستخراج فيديو Twitter/X من أجل الأتمتة، وأرشفة الوسائط، وسير عمل المحتوى، والأدوات الداخلية.

• Base URL: https://twitterdown.com/api/v1
• المصادقة: Bearer token (مفتاح API)
• صيغة الاستجابة: application/json

المصادقة

يجب أن يتضمن كل طلب مفتاح API صالحاً في ترويسة Authorization. المفاتيح مرتبطة بحسابك ويمكن إلغاؤها في أي وقت من لوحة التحكم.

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx

مفتاح API

1. سجّل الدخول إلى TwitterDown وفعّل خطة تدعم API.
2. افتح Dashboard > API Keys.
3. أنشئ مفتاحاً مع اسم يطابق تطبيقك أو بيئتك.

يظهر مفتاح API مرة واحدة فقط. خزّنه في مدير أسرار مناسب قبل مغادرة الصفحة.

النقاط الأساسية

POST /twitter

يقوم POST /twitter بتحليل رابط Tweet عام ويعيد الصورة المصغرة، ونسخ الفيديو، والنص، واسم المستخدم، ومعرّف الحالة.

POST https://twitterdown.com/api/v1/twitter
Content-Type: application/json
Authorization: Bearer sk-xxxx

{
  "url": "https://x.com/username/status/1234567890123456789"
}

استجابة ناجحة (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "thumbnail": "https://pbs.twimg.com/...jpg",
    "videos": [
      { "resolution": "720p", "quality": "HD", "url": "https://video.twimg.com/..." },
      { "resolution": "360p", "quality": "SD", "url": "https://video.twimg.com/..." }
    ],
    "text": "Tweet text",
    "username": "username",
    "statusId": "1234567890123456789",
    "processed_at": "2024-01-01T12:00:00.000Z"
  }
}

GET /twitter

يعيد بيانات وصفية عن endpoint لاستخدامها في التكاملات، وتهيئة SDK، وفحوصات التشغيل.

حدود الطلبات

• 60 طلباً / دقيقة
• 1,000 طلب / ساعة
• 10,000 طلب / يوم

اقرأ X-RateLimit-Limit و X-RateLimit-Remaining و X-RateLimit-Reset مع كل استجابة. عند تجاوز الحصة، تعيد API رمز HTTP 429 مع Retry-After.

معالجة الأخطاء

تعيد جميع الأخطاء استجابة JSON تحتوي على رمز رقمي ورسالة واضحة.

{
  "code": -1,
  "message": "Readable error message"
}

أمثلة

استخدم المقاطع التالية كنقطة بداية لعمليات التكامل الخلفية، وسكربتات الأتمتة، وأدوات المطورين الداخلية.

const res = await fetch("https://twitterdown.com/api/v1/twitter", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-xxxx"
  },
  body: JSON.stringify({ url })
});
const data = await res.json();

resp = requests.post(
  "https://twitterdown.com/api/v1/twitter",
  headers={
    "Authorization": "Bearer sk-xxxx",
    "Content-Type": "application/json",
  },
  json={"url": tweet_url},
)
print(resp.json())

هل تحتاج إلى أفكار أكثر للتنفيذ؟ تصفح أدلة API في المدونة للاطلاع على أنماط التكامل، وملاحظات الإطلاق، وأمثلة سير العمل.