مرجع الأوامر
ستة عشر أمرًا، في خمس مجموعات. نفذ sharek --help للقائمة نفسها، أو
sharek <command> --help لخيارات أمر واحد.
وكل أمر عدا أوامر auth:* الثلاثة يحتاج بيانات اعتماد أولًا. انظر تسجيل الدخول.
المنشورات
Section titled “المنشورات”posts:create
Section titled “posts:create”ينشئ منشورًا. وهو الأمر الأكثر خيارات على الإطلاق.
| الخيار | الاختصار | مطلوب | الافتراضي | ما الذي يفعله |
|---|---|---|---|---|
--content |
-c |
نعم، ما لم تستخدم --json |
محتوى المنشور. كرره: الأول هو المنشور، وكل واحد بعده تعليق أو الجزء التالي من سلسلة النقاش. | |
--integrations |
-i |
نعم، ما لم تستخدم --json |
معرفات القنوات مفصولة بفواصل. | |
--date |
-s |
نعم، ما لم تستخدم --json |
تاريخ الجدولة، بصيغة ISO 8601. | |
--media |
-m |
لا | عناوين الوسائط مفصولة بفواصل، لـ -c المقابل. كرره بجانب -c. |
|
--type |
-t |
لا | schedule |
schedule أو draft. |
--delay |
-d |
لا | 0 |
الدقائق بين التعليقات. |
--json |
-j |
لا | مسار ملف JSON يحمل المنشور كاملًا بدل الخيارات. | |
--shortLink |
لا | true |
اختصار الروابط في المحتوى. | |
--settings |
لا | إعدادات المنصة كنص JSON. |
منشور مجدول بسيط:
sharek posts:create -c "Our new pricing is live" \ -s "2027-09-01T09:00:00Z" -i "channel-id"سلسلة نقاش. ولاحظ أن --date مطلوب هنا كما في كل مكان، وأن -d يباعد بين الأجزاء:
sharek posts:create -c "Thread 1/3" -c "Thread 2/3" -c "Thread 3/3" \ -d 5 -s "2027-09-01T09:00:00Z" -i "channel-id"إعدادات المنصة تدخل كـ JSON. وصفحة الإعدادات لكل قناة، المدرجة تحت القنوات التي يوفرها شارك، توضح ما تقبله. والمثال أدناه لـ X:
sharek posts:create -c "Tweet content" -s "2027-09-01T09:00:00Z" \ --settings '{"who_can_reply_post":"everyone"}' -i "channel-id"ولأي شيء متشعب، ضع المنشور كاملًا في ملف وتجاوز الخيارات. فمع --json يأتي المحتوى
والقنوات والتاريخ من الملف:
sharek posts:create --json ./post.jsonالمقابل في API: إنشاء منشور.
posts:list
Section titled “posts:list”يسرد المنشورات. وبلا تواريخ يغطي 30 يومًا للوراء و30 يومًا للأمام.
| الخيار | الافتراضي | ما الذي يفعله |
|---|---|---|
--startDate |
قبل 30 يومًا | بصيغة ISO 8601. |
--endDate |
بعد 30 يومًا | بصيغة ISO 8601. |
--customer |
حصر النتائج في علامة تجارية واحدة، بمعرفها. |
sharek posts:list --startDate "2026-01-01T00:00:00Z" --endDate "2026-12-31T23:59:59Z"المقابل في API: سرد المنشورات.
posts:delete <id>
Section titled “posts:delete <id>”يحذف منشورًا.
sharek posts:delete post-idالمقابل في API: حذف منشور.
posts:status <id>
Section titled “posts:status <id>”ينقل منشورًا بين المسودة وقائمة الانتظار. و--status (-s) مطلوب ويأخذ draft أو
schedule.
sharek posts:status post-id --status scheduleوإعادة منشور من قائمة الانتظار إلى المسودة توقف نشره.
المقابل في API: تغيير حالة المنشور.
posts:missing <id>
Section titled “posts:missing <id>”لمنشور تم نشره ولم يسجل شارك معرف إصداره، يسرد هذا ما لدى المنصة، لتتعرف على المنشور الصحيح.
sharek posts:missing post-idوهذا هو الأمر الوحيد الذي يطبع JSON خامًا بلا سطر حالة فوقه.
المقابل في API: العثور على المحتوى المفقود.
posts:connect <id>
Section titled “posts:connect <id>”يسجل معرف الإصدار الذي تعرفت عليه. و--release-id مطلوب.
sharek posts:connect post-id --release-id "platform-content-id"وتحليلات ذلك المنشور تبدأ بالعمل بمجرد ربطه.
المقابل في API: تحديث معرف الإصدار.
القنوات
Section titled “القنوات”integrations:list
Section titled “integrations:list”يسرد القنوات المربوطة بمعرفاتها. و--group يأخذ معرف علامة تجارية ويحصر القائمة في
قنوات تلك العلامة.
sharek integrations:list --group "group-id"المقابل في API: سرد القنوات.
integrations:groups
Section titled “integrations:groups”يسرد علاماتك التجارية، بالمعرفات التي يأخذها --group و--customer. بلا خيارات.
وأسماء الخيارات تتبع API، التي تسمي العلامة التجارية group أو customer.
المقابل في API: سرد العلامات التجارية.
integrations:settings <id>
Section titled “integrations:settings <id>”يعيد ما تقبله القناة: قواعدها، وحد الأحرف، ومخطط الإعدادات، والأدوات المساعدة المتاحة لها. اقرأ هذا قبل أن تكتب أي شيء خاص بمنصة.
sharek integrations:settings channel-idالمقابل في API: جلب قواعد القناة ومخطط إعداداتها.
integrations:trigger <id> <method>
Section titled “integrations:trigger <id> <method>”ينفذ إحدى الأدوات المساعدة التي سردها integrations:settings، وهي طريقتك للبحث عن
المعرفات التي تحتاجها الإعدادات. و--data (-d) يمرر المعاملات كنص JSON.
sharek integrations:trigger channel-id subreddits -d '{"word":"programming"}'وأسماء الدوال تختلف بحسب المنصة وتراعي حالة الأحرف. خذها من مصفوفة tools الخاصة بتلك
القناة، لا من الذاكرة.
المقابل في API: تشغيل أداة قناة.
التحليلات
Section titled “التحليلات”analytics:platform <id>
Section titled “analytics:platform <id>”تحليلات القناة. و--date (-d) هو عدد الأيام للرجوع، والقيمة الافتراضية 7.
sharek analytics:platform channel-id -d 30المقابل في API: تحليلات القناة.
analytics:post <id>
Section titled “analytics:post <id>”تحليلات منشور واحد، بالخيار --date نفسه والقيمة الافتراضية نفسها.
sharek analytics:post post-id -d 30فإن أعاد هذا {"missing": true}، فالمنشور بلا معرف إصدار بعد. عالج ذلك بـ posts:missing
وposts:connect.
المقابل في API: تحليلات المنشور.
الوسائط
Section titled “الوسائط”upload <file>
Section titled “upload <file>”يرفع ملفًا ويعيد id وpath الخاصين به.
sharek upload ./image.pngالمقابل في API: رفع ملف.
المصادقة
Section titled “المصادقة”auth:login
Section titled “auth:login”يسجل الدخول عبر المتصفح. ولاستخدام خادم مصادقة مختلف، وهو ما لا تحتاجه عادة، مرر
--auth-server أو اضبط SHAREK_AUTH_SERVER. وإن ضبطت الاثنين فالأولوية للخيار.
auth:status
Section titled “auth:status”يبلغ عن الطريقة المستخدمة ويتحقق من أن بيانات الاعتماد ما زالت تعمل.
أقرب مقابل في API: التحقق من بيانات اعتمادك، الذي
يؤكد أن المفتاح يعمل. أما auth:status نفسه فيتحقق بسرد قنواتك.
auth:logout
Section titled “auth:logout”يحذف بيانات الاعتماد المحفوظة.
والثلاثة مغطاة في تسجيل الدخول.