وثائق المطوّرين
أوامر 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 logoutnpx sosoapi connect threads
npx sosoapi connect instagram --no-opennpx 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 إليه.
| المتغير | الأثر |
|---|---|
| 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. ينقّح المحتوى ويقصّه أيضاً، لكن يظل على وكيلك اعتباره بيانات لا صلاحية تنفيذ.