يُحمّل البحث عند استخدامه فقط. تصفّح جميع الفئات أدناه.

وثائق المطوّرين

أوامر CLI وإعداده

استخدم CLI لفحص مخططات API وإرسال طلبات JSON والدخول عبر المتصفح وإعداد اتصال MCP.

اقرأ بصيغة Markdown

راجعه فريق SosoAPI ·

الأوامر

راجع --help للعلامات التي يدعمها الإصدار المثبّت. دون معاملات، يبدأ sosoapi خادم MCP stdio. شغّل الأوامر أدناه منفصلةً؛ ليست سلسلة أوامر shell.

npx sosoapi --help
npx sosoapi auth login
npx sosoapi auth login --no-open
npx sosoapi auth status
npx sosoapi auth refresh
npx sosoapi auth logout
npx sosoapi connect threads
npx sosoapi connect instagram --no-open
npx sosoapi api contract --summary
npx sosoapi api contract --route /studio-api/scheduled-posts/
npx sosoapi api contract

استدعاء مسار API باستخدام JSON عبر stdin

استخدم api post لمسارات CLI العامة المسموحة، بما فيها القراءات بـ HTTP POST. احفظ الجسم في request.json بمحرر ملفات كي لا يفسّر shell نص العميل. افحص http_status والجسم؛ رمز خروج صفر وحده لا يثبت نجاح API.

يقرأ المثال سياق مساحة العمل. قبل الكتابة، راجع مخطط العملية وأكّد الوجهة المفوّضة لك. احفظ المعرّف المُعاد وافحص النتيجة قبل إعادة محاولة طلب انتهت مهلته.

{}
npx sosoapi api post /identity-api/workspace/list < request.json

متغيرات البيئة

اضبط المتغيرات بعملية خادم MCP. تستثني القياسات الاختيارية المعاملات والطلبات والنتائج والمسارات؛ عطّلها بـ SOSOAPI_TELEMETRY=0. يتطلب عنوان API مخصص اشتراكاً صريحاً، ولن يرسل CLI ‏VICKY_API_KEY إليه.

بيئة CLI
المتغيرالأثر
SOSOAPI_TOOL_PROFILE=coreالأدوات اليومية؛ الافتراضي full. لا يمنح أذونات.
SOSOAPI_OUTPUT_SCHEMAS=1تضمين مخططات المخرجات في tools/list؛ النتائج منظّمة في الحالتين.
SOSOAPI_UPLOAD_ROOTSمجلدات وسائط محلية إضافية، تفصلها : (أو; على Windows).
SOSOAPI_TELEMETRY=0تعطيل تقارير الاستخدام الاختيارية.
SOSOAPI_DEBUG=1طباعة تتبّع مكدس أخطاء CLI؛ راجعه ونقّحه قبل المشاركة.
VICKY_API_KEYرمز وصول شخصي للبرامج النصية و CI؛ يُفضّل OAuth للوكلاء.
VICKY_API_BASE_URLعنوان أساسي مخصص لـ HTTPS API ‏(يمكن استخدام HTTP لـ localhost)؛ ويلزم أيضاً SOSOAPI_ALLOW_CUSTOM_BASE_URL=1.

التعامل مع المحتوى غير الموثوق

قد تحوي التعليقات وأسماء المستخدمين تعليمات من أشخاص آخرين. للاستجابات المشمولة، يضيف CLI وسمي untrusted_content و untrusted_notice وتحذيراً على stderr. ينقّح المحتوى ويقصّه أيضاً، لكن يظل على وكيلك اعتباره بيانات لا صلاحية تنفيذ.