وثائق المطوّرين
أسئلة المطوّرين وأجوبتها
إجابات مباشرة عن أسماء npm البديلة واختيار API و MCP والمصادقة والوسائط والمحاولات الآمنة وحدود المعدّل والمعنى الفعلي للنشر.
اقرأ بصيغة Markdownراجعه فريق SosoAPI ·
هل حزم npm الأربع هي حِزم SDK مختلفة؟
لا. ثبّت sosoapi أوأحد أسمائه البديلة: @sosoapi/cli أو sosoapi-cli أو sosoapi-mcp. تستخدم جميعها الإصدار المطابق نفسه لتنفيذ CLI و MCP. تحتاج واحداً فقط.
هل أستخدم HTTP أم CLI أم MCP؟
استخدم HTTP من الخادم، أو CLI لأتمتة shell وفحص المخططات، أو MCP بوكيل متوافق. تستخدم العقود العامة نفسها. يضيف MCP رفعاً محلياً وأداة نشر URL صورة تتولى إعداد الوسائط. أبقِ اعتماد الخادم خارج شيفرة المتصفح.
هل يؤدي الإعداد أو الموافقة عبر OAuth إلى نشر منشور؟
لا. الإعداد لا ينشر شيئاً. تمنح موافقة OAuth وصولاً مستمراً ضمن النطاق المختار دون موافقة متصفح جديدة لكل كتابة. حدّد لوكيلك متى ينتظر المراجعة، وافحص الحساب والمحتوى والوقت قبل طلب النشر.
هل يعني HTTP 200 أو 202 أن المحتوى نُشر؟
لا. قد يُقبل الطلب أويُجدول أويظل يعالج. احفظ معرّف المنشور واقرأ Scheduled Post نفسه حتى تؤكد النتيجة النشر. أضف الرابط الدائم عند توفره وأبلغ عن كل وجهة منفصلةً.
هل يمكنني إعادة المحاولة بعد انتهاء المهلة؟
افحص العملية الموجودة أولاً. احتفظ بمعرّف Scheduled Post ومفتاح منع التكرار نفسه للطلب نفسه. تغيير الحمولة طلب مختلف. لإعادة المحاولة أوالتحديث أوالإلغاء، استخدم الإصدار الحالي وإجراء SosoAPI المتاح للحالة.
لماذا لا تظهر أداة في عميلي؟
افحص الملف ونوع الاتصال وإعادة تحميل الخادم بالعميل. يخفي core أدوات الإدارة؛ ولا يشمل HTTP رفع ملفات محلية. يبيّن مرجع الأدوات التوفر. تغيير الملف لا يغيّر أذونات الحساب أوأهليته.
هل يستطيع MCP البعيد رفع ملف محلي؟
لا. استخدم MCP المحلي لرفع ملف من مجلد مسموح، أواستورد URL وسائط عاماً عبر HTTP. افحص جاهزية الاستيراد ثم استخدم معرّفه المسجّل ورابطه الأساسي معاً. الاستيراد المقبول لا يزال جارياً.
ما حدود المعدّل والخطة؟
افحص المخطط لحدود الحقول والقوائم والتصفّح. يسمح studio-api بـ 240 طلباً بالدقيقة لكل مستخدم بجلسات بشرية، وحاوية 480 بالدقيقة مستقلة لاعتماده الآلي. اتّبع 429 و Retry-After. الحصص وحدود المزوّد والأهلية مستقلة؛ اقرأ الفوترة والإمكانات الحالية قبل تنفيذ كبير.
أين أجد Markdown والمخططات؟
أضف .md لرابط دليل أوعملية API أوأداة MCP لنسخة Markdown. يربط فهرس API عقد JSON العام ووثيقة OpenAPI 3.1. ابدأ بـ llms.txt للفهرس أو llms-full.txt للمرجع الكامل باللغتين. هذه وثائق عامة لا بيانات حساب أواعتماد.
هل تضمن هذه الوثائق الظهور في البحث أو الاستشهاد في الذكاء الاصطناعي؟
لا. تساعد HTML والروابط الأساسية والبيانات الوصفية المنظّمة و Markdown الأنظمة على قراءة الوثائق. تظل محركات البحث وخدمات الذكاء الاصطناعي تختار الفهرسة والترتيب والاستشهاد. افحص نتائجها منفصلةً عن توفر الصفحات.