API Hop

الوثائق

وثائق API Hop

واجهة Twitter API

>-

توفر هذه الخدمة واجهة Twitter REST موحدة. يتلقى المستدعون بنيات استجابة متسقة بأسلوب X API v2.

text
/v1/twitter

المصادقة

تتطلب جميع نقاط نهاية Twitter API المصادقة برمز Bearer.

http
Authorization: Bearer YOUR_API_KEY

المسار الأساسي

استدع هذه المسارات النسبية ضمن API Base URL لديك.

text
GET https://api.apihop.ai/v1/twitter/users
GET https://api.apihop.ai/v1/twitter/users/{id}
GET https://api.apihop.ai/v1/twitter/users/{id}/tweets

بنية الاستجابة

لا تغلف استجابات Twitter API الناجحة داخل success/data؛ بل تعيد الحقول الموحدة data وincludes وmeta مباشرة.

القدرات المدعومة

معلومات المستخدماستعلم عن مستخدم Twitter باستخدام username، أو استعلم عن مورد المستخدم مباشرة باستخدام id.منشورات المستخدماستعلم عن منشورات المستخدم باستخدام id، بما فيها التغريدات الموحدة وبيانات المؤلفين الموسعة وبيانات ترقيم الصفحات.
  1. إذا كان لديك username فقط، فاستدع جلب المستخدم باسم المستخدم أولا واقرأ data.id.
  2. استخدم data.id لاستدعاء جلب منشورات المستخدم.
  3. إذا احتجت إلى بيانات ملفات المؤلفين في استجابات المنشورات، فمرر expansions=author_id.

قواعد توحيد البنية

  • تعيد نقاط نهاية المستخدم كائن مستخدم واحدا: { "data": { ... } }
  • تعيد نقاط نهاية المنشورات مصفوفة تغريدات: { "data": [ ... ], "meta": { ... } }
  • عند طلب expansions=author_id، تتضمن استجابات المنشورات includes.users
  • يتحكم user.fields وtweet.fields في اختيار الحقول الاختيارية
  • تحتفظ كائنات المستخدم دائما بـid وname وusername
  • تحتفظ كائنات التغريدة دائما بـid وtext

الحقول الاختيارية

user.fields

حقول المستخدم الموحدة المدعومة:

  • created_at
  • description
  • entities
  • location
  • pinned_tweet_id
  • profile_banner_url
  • profile_image_url
  • protected
  • public_metrics
  • url
  • verified
  • verified_type

tweet.fields

حقول التغريدة الموحدة المدعومة:

  • attachments
  • author_id
  • conversation_id
  • created_at
  • edit_history_tweet_ids
  • entities
  • in_reply_to_user_id
  • lang
  • possibly_sensitive
  • public_metrics
  • referenced_tweets
  • source

التشخيص

  • تتضمن كل استجابة X-Request-Id
  • سجله عند فشل الاستدعاءات أو ظهور نتائج غير معتادة أو إرجاع الخدمة حدود المعدل
  • لاستفسارات الفوترة، احتفظ بـX-Request-Id ووقت الطلب

نقاط النهاية

جلب المستخدم باسم المستخدمGET https://api.apihop.ai/v1/twitter/users?username=elonmuskجلب المستخدم بالمعرفGET https://api.apihop.ai/v1/twitter/users/44196397جلب منشورات المستخدمGET https://api.apihop.ai/v1/twitter/users/44196397/tweets