يُحمّل البحث عند استخدامه فقط. تصفّح جميع الفئات أدناه.
SosoAPI · وثائق المطوّرين
مرجع API
107 عمليات تستدعيها من تطبيقك، و 4 نقاط نهاية لدخول الوكيل. افتح عملية لحقول الطلب والاستجابة والأذونات وأمثلة الاستدعاء.
الحسابات ومساحات العمل
- جلب سياق المؤسسة
POST /identity-api/agent/organization-contextقراءة صلاحيات المؤسسة ومساحة العمل والقناة الحالية. - إنشاء مفتاح API
POST /identity-api/api-keys/createإنشاء مفتاح API بإمكانات مختارة وحدود مساحة عمل اختيارية؛ يُعاد السر مرة واحدة. يمنح الوكيل ما يملكه تفويضه فقط حتى 30 يوماً، ولكل تفويض حتى 25 مفتاحاً نشطاً (API_KEY_GRANT_KEY_LIMIT). - تمديد صلاحية مفتاح API
POST /identity-api/api-keys/extendتمديد انتهاء مفتاح API حتى 365 يوماً من الآن (30 لمفتاح أنشأه وكيل)؛ يُرفض الأبعد برمز API_KEY_LIFETIME_EXCEEDS_CAP. تحمل الاستجابة الانتهاء المُطبّق. - عرض مفاتيح API
POST /identity-api/api-keys/listعرض البيانات الوصفية لمفاتيح API دون أسرار؛ اضبط include_authority للإمكانات وحدود مساحة العمل. - تجديد مفتاح API
POST /identity-api/api-keys/renewإنشاء مفتاح API لاحق دون إبطال السابق، بالإمكانات وحدود مساحة العمل نفسها. - إلغاء مفتاح API
POST /identity-api/api-keys/revokeإلغاء مفتاح API. يمكن للوكيل إلغاء المفاتيح التي أنشأها فقط. - جلب حالة الفوترة
POST /identity-api/billing/statusقراءة حقائق خطة الفوترة والاستحقاقات والحصص. - الحصول على الوصول التجاري
POST /identity-api/commercial-access/statusقراءة حقائق الوصول التجاري لمساحة العمل. - إرسال ملاحظات
POST /identity-api/feedback/submitإرسال ملاحظات عن المنتج مع إسنادها لصاحبها. - عرض أعضاء مساحة العمل
POST /identity-api/member/listقراءة الأعضاء والدعوات المعلّقة. - عرض قنوات المؤسسة
POST /identity-api/organization/channels/listعرض القنوات وحالة ارتباطها بمساحة العمل. - معاينة نقل القناة
POST /identity-api/organization/channels/move/previewمعاينة العوائق قبل نقل قناة. - عرض اتصالات المؤسسة
POST /identity-api/organization/connections/listقراءة اتصالات مزوّدي الخدمة في المؤسسة. - مراجعة اتصال المؤسسة
POST /identity-api/organization/connections/reviewقراءة الموارد الفعلية التي اكتُشفت لدى مزوّد الخدمة للمراجعة. - عرض المؤسسات
POST /identity-api/organization/listعرض المؤسسات المرئية للمستخدم المصادَق عليه. - عرض إشعارات صندوق الوارد
POST /identity-api/user/inbox/listقراءة صندوق الوارد للمستخدم المصادَق عليه. - جلب تفضيلات الإشعارات
POST /identity-api/user/notifications/getقراءة تفضيلات تسليم الإشعارات. - تحديث تفضيلات الإشعارات
POST /identity-api/user/notifications/updateتحديث تفضيلات تسليم الإشعارات. - جلب الملف الشخصي للمستخدم
POST /identity-api/user/profile/getقراءة الملف الشخصي للمستخدم المصادَق عليه. - توقيع رفع الصورة الشخصية
POST /identity-api/user/profile/sign-avatar-urlجلب URL موقّع لرفع الصورة الشخصية. - تحديث الملف الشخصي للمستخدم
POST /identity-api/user/profile/updateتحديث الملف الشخصي للمستخدم المصادَق عليه. - إزالة الحظر عن حساب اجتماعي
POST /identity-api/user/social-accounts/clear-blockإزالة تهدئة حساب دون إعادة محاولة منشور. تُرفض بيانات اعتماد الوكيل أثناء التهدئة النشطة أوبعد بلوغ الحساب تهدئته الثالثة؛ لأي مستدعٍ إزالة تهدئة الحساب مرة كل 10 دقائق كحد أقصى. - فصل حساب تواصل اجتماعي
POST /identity-api/user/social-accounts/disconnectفصل حساب اجتماعي في مساحة العمل. - عرض الحسابات المتصلة
POST /identity-api/user/social-accounts/listعرض الحسابات الاجتماعية المتصلة في مساحة عمل. - تعيين المزامنة التلقائية للحساب الاجتماعي
POST /identity-api/user/social-accounts/set-auto-syncتفعيل المزامنة التلقائية للحساب أو تعطيلها. - إنشاء مساحة عمل
POST /identity-api/workspace/createإنشاء مساحة عمل في مؤسسة تملكها أو تديرها. مرّر organization_id إذا كنت تنتمي إلى مؤسسات متعددة. - جلب سياق مساحة العمل
POST /identity-api/workspace/listعرض مساحات العمل ومساحة العمل النشطة. - تحديث مساحة العمل
POST /identity-api/workspace/updateتحديث اسم مساحة العمل أو slug.
الوسائط والأصول
- إنشاء أصل
POST /assets-api/createتسجيل بيانات الأصل الوصفية. - حذف أصل
POST /assets-api/deleteحذف أصل واحد. - إنشاء تصدير للأصول
POST /assets-api/exports/createإنشاء مهمة لأدلة تصدير الأصول. - جلب حالة تصدير الأصول
POST /assets-api/exports/statusقراءة الحالة الدائمة لتصدير الأصول. - التحقّق من تصدير الأصول
POST /assets-api/exports/verifyالتحقّق من تصدير الأصول قبل أي إزالة. - جلب أصل
POST /assets-api/getقراءة أصل واحد حسب المعرّف. - جلب حالة استيراد الأصول
POST /assets-api/imports/statusقراءة الحالة الدائمة لاستيراد الوسائط. - استيراد أصل من URL
POST /assets-api/imports/urlإدراج استيراد الوسائط الخارجية الصريح في القائمة. - الاستعلام عن الأصول
POST /assets-api/listالاستعلام عن الأصول بمرشحات متوافقة مع النظام السابق. - عرض الأصول
POST /assets-api/list-workspaceعرض أصول مساحة العمل. - حذف الأصول اليتيمة
POST /assets-api/orphans/deleteحذف عناصر R2 غير المسجّلة المحددة. - عرض الأصول اليتيمة
POST /assets-api/orphans/listعرض عناصر R2 غير المسجّلة. - طلب إزالة أصل
POST /assets-api/purges/requestطلب إزالة أصل بضوابط تحقّق من المالك. - إعادة محاولة إزالة الأصل
POST /assets-api/purges/retryإعادة محاولة إزالة مؤهلة ومحميّة بضوابط التنفيذ. - جلب مخزون تخزين الأصول
POST /assets-api/storage/inventoryقراءة مخزون محدود من الأصول المسجّلة وعناصر التخزين. - تحديث أصل
POST /assets-api/updateتحديث بيانات الأصل الوصفية. - إكمال رفع أصل
POST /assets-api/upload/completeإكمال تسجيل عنصر وسائط مساحة العمل المرفوع باستخدام هوية العنصر الموقّعة ومفتاح منع التكرار. - توقيع رفع أصل
POST /assets-api/upload/signطلب URL رفع موقّع لعنصر الوسائط المقصود في مساحة العمل. ارفع البايتات قبل إكمال التسجيل.
المشاريع والمحتوى
- جلب الإعدادات الافتراضية لحساب المشروع
POST /studio-api/projects/account-defaults/getقراءة الإعدادات الافتراضية لحساب المشروع. - استبدال الإعدادات الافتراضية لحساب المشروع
POST /studio-api/projects/account-defaults/replaceاستبدال الإعدادات الافتراضية لحساب المشروع. - ربط حساب بالمشروع
POST /studio-api/projects/accounts/linkربط حساب اجتماعي بمشروع. - عرض حسابات المشروع
POST /studio-api/projects/accounts/listعرض الحسابات المرتبطة بمشروع. - إلغاء ربط حساب بالمشروع
POST /studio-api/projects/accounts/unlinkإلغاء ربط حساب اجتماعي بمشروع. - أرشفة مشروع
POST /studio-api/projects/archiveأرشفة مشروع دون تغيير Scheduled Posts التابعة له. لإيقاف منشور، ألغِ Scheduled Post المعني منفصلاً. لمالك مساحة العمل فقط؛ مرّر expected_lifecycle_version و idempotency_key. - ربط أصل بالمشروع
POST /studio-api/projects/assets/linkربط أصل بمشروع. - عرض أصول المشروع
POST /studio-api/projects/assets/listعرض الأصول المرتبطة بمشروع. - إلغاء ربط أصل بالمشروع
POST /studio-api/projects/assets/unlinkإلغاء ربط أصل بمشروع. - إنشاء مشروع
POST /studio-api/projects/createإنشاء مشروع. - إنشاء تصدير للمشروع
POST /studio-api/projects/export/createإنشاء تصدير لمشروع. - جلب حالة تصدير المشروع
POST /studio-api/projects/export/statusقراءة حالة تصدير المشروع. - جلب مشروع
POST /studio-api/projects/getقراءة مشروع. - جلب سجل دورة حياة المشروع
POST /studio-api/projects/lifecycle/historyقراءة سجل دورة حياة المشروع. - عرض المشاريع
POST /studio-api/projects/listعرض مشاريع مساحة العمل. - جلب ملف المشروع
POST /studio-api/projects/profile/getقراءة ملف مشروع. - تحديث ملف المشروع
POST /studio-api/projects/profile/updateتحديث ملف مشروع. - تعيين المشروع النشط
POST /studio-api/projects/set-activeتعيين المشروع النشط. - إلغاء أرشفة مشروع
POST /studio-api/projects/unarchiveإعادة تنشيط مشروع مؤرشف. لا يستأنف المنشورات أويعيد جدولتها؛ أدِرها عبر Scheduled Posts. لمالك مساحة العمل فقط؛ مرّر expected_lifecycle_version و idempotency_key. - تحديث مشروع
POST /studio-api/projects/updateتحديث مشروع. - عرض ما يستلزم الانتباه في النشر
POST /studio-api/publication-attentions/listقراءة نتائج النشر التي تستدعي الانتباه.
الجدولة والنشر
- إنشاء منشورات مجدولة جماعياً
POST /studio-api/scheduled-posts/bulk-createإنشاء منشورات مجدولة لوجهات متعددة. - إلغاء منشور مجدول
POST /studio-api/scheduled-posts/cancelإلغاء منشور مجدول. - إنشاء منشور مجدول
POST /studio-api/scheduled-posts/createإنشاء منشور مجدول وفحص النتيجة النهائية للنشر. - إرسال منشور صورة مكتمل
POST /studio-api/scheduled-posts/create-image-urlقبول منشور URL صورة مكتمل واحد بشكل دائم وإرجاع نتيجته النهائية عند توفرها. - حذف منشور مجدول
POST /studio-api/scheduled-posts/deleteحذف منشور مجدول. - جلب أهلية المنشور المجدول
POST /studio-api/scheduled-posts/eligibilityقراءة أهلية الوجهة قبل الجدولة. - جلب منشور مجدول
POST /studio-api/scheduled-posts/getقراءة منشور مجدول واحد. - عرض المنشورات المجدولة
POST /studio-api/scheduled-posts/listعرض المنشورات المجدولة. - نشر منشور مجدول الآن
POST /studio-api/scheduled-posts/publish-nowطلب النشر الفوري. - إعادة محاولة منشور مجدول
POST /studio-api/scheduled-posts/retryإعادة محاولة منشور مجدول فاشل. - تحديث منشور مجدول
POST /studio-api/scheduled-posts/updateتحديث منشور مجدول. - سحب طلب الحذف
POST /studio-api/scheduled-posts/withdraw-deleteسحب طلب حذف Instagram Login متوقف والاحتفاظ بالمنشور المنشور. - جلب رصيد النشر على X
POST /studio-api/x/usageقراءة أرصدة X المشتركة للمؤسسة وتكلفة الرصيد لنص المنشور النهائي الاختياري.
التحليلات والرؤى
- جلب أعداد لوحة المعلومات
POST /analytics-api/dashboard/ops-countsقراءة الأعداد التشغيلية للوحة المعلومات. - طلب رؤى مزوّد الخدمة
POST /analytics-api/provider-insights/requestطلب رؤى تكون مرجعيتها مزوّد الخدمة. - جلب حالة رؤى مزوّد الخدمة
POST /analytics-api/provider-insights/statusقراءة حالة طلب رؤى مزوّد الخدمة. - عرض تعليقات المنشور
POST /analytics-api/social/comments/queryقراءة التعليقات الاجتماعية المكتشفة. - عرض المنشورات المراقَبة
POST /analytics-api/social/posts/queryقراءة المنشورات الاجتماعية المكتشفة.
حسابات التواصل المتصلة
- بدء Instagram OAuth
POST /oauth-api/instagram/initبدء موافقة مزوّد الخدمة وإرجاع URL التفويض الأصلي. - تحديث Instagram OAuth
POST /oauth-api/instagram/refreshتحديث اتصال Instagram. - بدء Meta OAuth
POST /oauth-api/meta/initبدء موافقة مزوّد الخدمة وإرجاع URL التفويض الأصلي. - تحديث Meta OAuth
POST /oauth-api/meta/refreshتحديث اتصال Meta. - فحص Threads OAuth
POST /oauth-api/threads/checkقراءة تشخيص اتصال Threads. - بدء Threads OAuth
POST /oauth-api/threads/initبدء موافقة مزوّد الخدمة وإرجاع URL التفويض الأصلي. - تحديث Threads OAuth
POST /oauth-api/threads/refreshتحديث اتصال Threads. - بدء YouTube OAuth
POST /oauth-api/youtube/initبدء موافقة مزوّد الخدمة وإرجاع URL التفويض الأصلي. - تحديث YouTube OAuth
POST /oauth-api/youtube/refreshتحديث اتصال YouTube.
العمليات الخلفية
التعليقات والمجتمع
- تطبيق إجراء مجتمعي
POST /community-engagement-api/actions/applyتطبيق إجراء مُعدّ؛ افحص حالة الإجراء لمعرفة النتيجة النهائية المعتمدة. - إعداد إجراء مجتمعي
POST /community-engagement-api/actions/prepareإعداد إجراء مجتمعي نهائي. - جلب حالة الإجراء المجتمعي
POST /community-engagement-api/actions/statusقراءة إيصال الإجراء النهائي؛ الإدراج في القائمة لا يعني النجاح. - جلب إمكانات المجتمع
POST /community-engagement-api/capabilitiesقراءة حقائق إمكانات التفاعل المجتمعي. - إنشاء تعليق مجتمعي
POST /community-engagement-api/comments/createإدراج تعليق محدد واحد لمنشور أو تعليق أساسي مستهدف؛ الحالة لا تعني نجاح مزوّد الخدمة. - جلب نتيجة تسليم التعليق
POST /community-engagement-api/comments/outcomeقراءة التسليم المؤكد وتسلسل الاسترداد والتحقّق المعلّق والمتابعة التي لم تُحسم. - تسوية نتيجة تسليم التعليق
POST /community-engagement-api/comments/reconcileالتحقّق من تسليم Facebook غامض دون إعادة إرسال، أو ربط بديل مطابق واحد مؤكّد. افحص outcome للدليل النهائي. - جلب حالة التعليق المجتمعي
POST /community-engagement-api/comments/statusقراءة الإيصال النهائي المنقّح لإجراء تعليق مباشر. - جلب ملخص المجتمع
POST /community-engagement-api/operations/summaryقراءة الملخص التشغيلي للتفاعل المجتمعي. - الاستعلام عن قائمة المراجعة المجتمعية
POST /community-engagement-api/review-queue/queryقراءة التعليقات القابلة للمراجعة؛ الصفحة الفارغة لا تعني النجاح. - إرسال مراجعة مجتمعية
POST /community-engagement-api/reviews/submitإرسال نسخة مراجعة جديدة غير قابلة للتعديل.
تهيئة المصادقة
- مصادقة الوكيل: config
POST /identity-api/agent-auth/configبروتوكول config لمصادقة الوكيل. استخدم مسار الدخول المدعوم عبر المتصفح؛ لا تعرض بيانات الاعتماد أبداً. - مصادقة الوكيل: request
POST /identity-api/agent-auth/requestبروتوكول request لمصادقة الوكيل. استخدم مسار الدخول المدعوم عبر المتصفح؛ لا تعرض بيانات الاعتماد أبداً. - مصادقة الوكيل: revoke-current
POST /identity-api/agent-auth/revoke-currentبروتوكول revoke-current لمصادقة الوكيل. استخدم مسار الدخول المدعوم عبر المتصفح؛ لا تعرض بيانات الاعتماد أبداً. - مصادقة الوكيل: session
POST /identity-api/agent-auth/sessionبروتوكول session لمصادقة الوكيل. استخدم مسار الدخول المدعوم عبر المتصفح؛ لا تعرض بيانات الاعتماد أبداً.