الانتقال إلى المحتوى الرئيسي
GET
احصل على جميع الملفات الشخصية المرتبطة بالملف الأساسي. لا يتم إرجاع الملف الأساسي في النتائج. للأمان، لا يتم إرجاع Profile Keys عبر استدعاء GET هذا. يُرجى الاطلاع هنا لمزيد من المعلومات.

معلمات الرأس

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

title
string
أعِد فقط الملف الشخصي المرتبط بالعنوان المشفَّر بصيغة URL.
refId
string
أعِد فقط الملف الشخصي المرتبط بـ refId المحدّد. تم إرجاع refId أثناء إنشاء الملف الشخصي أو من نقطة النهاية /user.
hasActiveSocialAccounts
boolean
افتراضي:false
إذا كانت القيمة true فأعد فقط الملفات الشخصية التي تحتوي على حساب اجتماعي واحد متّصل على الأقل (طول activeSocialAccounts أكبر من صفر). إذا كانت false فأعد فقط الملفات الشخصية التي تحتوي على صفر من الحسابات الاجتماعية المتّصلة (طول activeSocialAccounts هو صفر).
includesActiveSocialAccounts
array
تصفية الملفات الشخصية لتضمين تلك التي تحتوي activeSocialAccounts الخاصّة بها على جميع منصّات وسائل التواصل الاجتماعي المحدّدة في قائمة includesActiveSocialAccounts. يمكن أن تحتوي الملفات الشخصية على منصّات إضافية في activeSocialAccounts بخلاف تلك المدرَجة في includesActiveSocialAccounts وأن تبقى مضمّنة في النتائج المفلترة.القيم: bluesky وfacebook وgmb وinstagram وlinkedin وpinterest وreddit وsnapchat وtelegram وthreads وtiktok وtwitter وyoutube.
isByokLinked
boolean
تصفية الملفات الشخصية حسب حالة ترحيل BYOK (Bring Your Own Key). إذا كانت true، فأعد فقط الملفات الشخصية التي أكملت ترحيل BYOK. إذا كانت false، فأعد فقط الملفات الشخصية التي تحتوي على منصّة مؤهّلة لـ BYOK متّصلة ولكن لم يتم ترحيلها بعد. يتم استبعاد الملفات الشخصية التي لا تحتوي على منصّة مؤهّلة لـ BYOK عند تعيين هذا المرشّح. عند حذفه، تتم إعادة جميع الملفات الشخصية بغضّ النظر عن حالة BYOK. ينطبق حاليًا على X/Twitter BYOK.
actionLog
boolean
افتراضي:false
إعادة سجل إجراءات إنشاء وحذف ملف تعريف المستخدم لآخر 60 يومًا وعدد المستخدمين النشطين المستخدم للفوترة لآخر 60 يومًا. ملاحظة:
  • Action Log: لن يتم إرجاع العنوان والوسوم لسجل الإجراءات قبل مارس 2025.
  • User Profile Report: قد لا تتوافق الفترة الزمنية مع فترة الفوترة الخاصة بك. على سبيل المثال، قد تبدأ فترة الفوترة الخاصة بك وتنتهي في العاشر من الشهر. يُرجى الاطلاع على فواتيرك للاطلاع على فترة الفوترة والتفاصيل الأخرى.
يمكنك تحديد فترة زمنية مختلفة بتعيين actionLog إلى عدد من الأيام. على سبيل المثال، ستُرجع معلمة الاستعلام actionLog=10 سجل الإجراءات لآخر 10 أيام وعدد المستخدمين النشطين المُبلَّغ عنه لآخر 10 أيام. الفترة الزمنية المسموح بها من 1 يوم إلى 365 يومًا.
limit
number
افتراضي:5000
حدّد عدد الملفات الشخصية المعادة. الافتراضي والحد الأقصى هو 5000.
cursor
string
إذا كان هناك ملفات شخصية إضافية للإرجاع وكان علم hasMore هو true، فسيتم إرجاع nextCursor في الاستجابة. مرّر هذا المؤشر إلى معلمة الاستعلام cursor لإرجاع المجموعة التالية من الملفات الشخصية.
include
string | array
إعادة بيانات ملف شخصي موسّعة لاستكشاف الأخطاء وإصلاحها. تتطلّب معلمة refId (بحث ملف شخصي واحد).القيم (سلسلة مفصولة بفواصل أو مصفوفة): suspension وsocialHealth وlinkingErrors وactivity وquota وunlinkHistory وactionLog.
  • suspension - isSuspended, reason, suspendedAt, unsuspendAt, suspensionCount
  • socialHealth - لكل منصّة: linked, linkedAt, relinkRecommended, messagingEnabled, tokenExpiresAt
  • linkingErrors - لكل منصّة: code, message, details, createdAt
  • activity - lastApiCall, lastPost timestamps
  • quota - used, limit
  • unlinkHistory - آخر إلغاء ربط: platform, source (user/system), details, createdAt
  • actionLog - سجل إجراءات الملف الشخصي (create/update/delete)