Skip to main content
GET
تسترجع نقطة النهاية هذه معلومات مفصّلة عن المستخدم أو ملف المستخدم المُصادق عليه، بما في ذلك:
  • قائمة شاملة بجميع حسابات وسائل التواصل الاجتماعي المربوطة
  • أسماء مستخدمي وسائل التواصل الاجتماعي ومعلومات الملف الشخصي
  • حالة الحساب ومقاييس الاستخدام
تعكس البيانات المُعادة حالة شبكات التواصل الاجتماعي المتصلة اعتبارًا من آخر تحديث، وتُحدَّث كلما ربط المستخدمون أو فصلوا حسابات وسائل التواصل الاجتماعي الخاصة بهم.
تخزين الاستجابة مؤقتًا. تُخزَّن الاستجابات مؤقتًا لمدة تصل إلى 60 ثانية. يصف الحقلان lastUpdated وnextUpdate نافذة التخزين المؤقت هذه: lastUpdated هو وقت إنشاء اللقطة، وnextUpdate هو وقت انتهاء صلاحيتها.nextUpdate هو علامة انتهاء صلاحية للتخزين المؤقت، وليس إشارة جاهزية. يُوسَم به كل استجابة، بما في ذلك الاستجابة التي لا يُدرج فيها displayNames بعدُ حسابًا تلقيت بشأنه إشعارًا للتو، لذا لا يمكنه إخبارك بموعد اكتمال انتشار حساب مربوط حديثًا.إذا كنت تُوفّق إشعار social webhook لربط جديد كليًا، فاستعلم بشكل متكرر حتى يظهر الحساب المتوقع فعليًا في displayNames — لا تعتبر استجابة واحدة، أو وصول nextUpdate، تأكيدًا بأن الربط غائب أو مكتمل.
username مقابل displayName في Threads. في إدخال Threads ضمن displayNames، يمثّل username المعرّف (handle) الخاص بالحساب (مثل ayrshare)، ويمثّل displayName الاسم المعروض في الملف الشخصي (مثل Ayrshare). قد تختلف القيمتان، لذا استخدم username أو profileUrl للعثور على حساب Threads.
إذا لم تكن هناك حسابات اجتماعية مربوطة، فلن يتم إرجاع activeSocialAccounts. احصل على بيانات لملف مستخدم معيّن بإضافة Profile-Key في الترويسة.
  • إذا كانت شركتك تتطلب جمع جميع بيانات ملفات المستخدمين مرة واحدة، فيُرجى استخدام نقطة نهاية /user/batch.
  • إذا كنت بحاجة إلى إشعار عند ربط مستخدم أو فصله لحساب اجتماعي، فيُرجى الاطلاع على نقطة نهاية /webhooks.

معاملات الترويسة

معاملات الاستعلام

boolean
افتراضي:false
يُرجع تفاصيل Instagram الإضافية مثل نوع الحساب (business أو creator) والحصة المستخدمة. لا يوصى به إلا إذا كنت بحاجة إلى البيانات الإضافية لأنه سيُبطئ وقت الاستجابة.

حصة المنشورات الشهرية

تعرض الاستجابة مقدار ما استُهلك من حصة المنشورات الشهرية للملف الشخصي:
  • monthlyPostCount: المنشورات المحتسبة من الحصة هذا الشهر.
  • monthlyPostQuota: الحد الشهري. يُحذف عندما تكون الحصة 10,000 أو أكثر، على سبيل المثال في خطط Business. ويظل الحد مطبقًا.
يُعاد تعيين العدّاد في اليوم الأول من كل شهر الساعة 00:07 UTC، وليس في تاريخ الفوترة الخاص بك. تُحتسب أيضًا محاولات النشر الفاشلة. monthlyApiCalls عدّاد مختلف وليس حصة المنشورات. راجع ما هو الحد المسموح به من المنشورات ومكالمات API؟ لمعرفة ما يُحتسب وما يحدث عند نفاد الحصة.