CLIAPI

جدولة ونشر من الطرفية

fopost هو CLI الرسمي من FoPost: ملف تنفيذي ثابت واحد بلا أي شيء آخر لتثبيته. أنشئ منشوراً وأرفق الوسائط وجدوله على كل الحسابات المتصلة وتحقق من كل عملية تسليم، من الصدفة أو من سكربت أو من مهمة CI.

brew install fopost/tap/fopost
fopost auth login

fopost posts create \
  --account acc_9f2c4a7b \
  --account acc_1ee3d5a0 \
  --text "We shipped dark mode. Every surface, every chart." \
  --media ./screenshots/dark-mode.png \
  --schedule-at "2026-09-01 09:00"

ملف تنفيذي واحد

macOS وLinux وWindows على amd64 وarm64. ثبّته عبر Homebrew أو go install أو أرشيف الإصدار.

مصمم للسكربتات

كل أمر يقبل --json، وتذهب الأخطاء إلى stderr، ولكل فشل رمز خروج خاص به.

لا نشر مفاجئ

يبقى المنشور مسودة حتى تمرر --publish أو تشغّل posts publish أو تحدد موعداً.

المنشورات

أنشئ وجدول وانشر بأمر واحد

يأخذ posts create الحسابات والنص وملفات الوسائط المحلية والوقت. تُرفع الملفات إلى مكتبة الوسائط وتُرفق نيابة عنك. يأتي النص الطويل من ملف أو من أنبوب، ويفحص preflight المنشور مقابل كل شبكة مستهدفة قبل إرسال أي شيء.

اقرأ أوامر posts
المنشورات
git log -1 --pretty=%s | \
  fopost posts create --account acc_9f2c4a7b --text-file - --draft

fopost posts preflight post_7d2a
fopost posts publish post_7d2a
fopost posts deliveries post_7d2a

جدولة أو نشر

مرر وقتاً للجدولة، أو --publish للإرسال فوراً، أو لا شيء للاحتفاظ بمسودة.

Preflight

اعرف أي الحسابات جاهزة وأيها محظورة، ولماذا، قبل النشر.

حالة التسليم

الحالة لكل حساب، والمحاولات، والرابط المباشر حالما تتوفر لدى الشبكة.

السكربتات

مخرجات JSON ورموز خروج

أضف --json إلى أي أمر ومرّر النتيجة إلى jq. أخطاء 401 و404 وحد المعدل والطلب الخاطئ تنتهي كلها برموز مختلفة، فيميّز السكربت بينها دون تحليل النص. تتم إعادة المحاولة والتأخير التدريجي في الخلفية لكل طلب.

اقرأ دليل السكربتات
الحسابات التي تحتاج إلى انتباه
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

--json في كل مكان

المورد نفسه، بمسافات بادئة، على stdout. الجداول للبشر.

رموز خروج متمايزة

للمدخلات الخاطئة والمصادقة والصلاحيات وعدم العثور وحد المعدل وأخطاء الخادم رمز لكل منها.

إعادة محاولة مدمجة

تُعاد محاولة حدود المعدل وأخطاء الخادم وأعطال الشبكة مع تأخير تدريجي.

CI

انشر من خط الإنتاج لديك

عيّن مفتاح API كسر، ومرر مساحة العمل، ولن يحتاج CLI إلى إعدادات محفوظة. أعلن عن إصدار، أو شارك سجل التغييرات، أو امنع الدمج عند فشل preflight. ولـ GitHub يوجد أيضاً Action رسمي يغلّف التدفق نفسه.

ابدأ البناء
ملاحظات الإصدار عند كل وسم
FOPOST_API_KEY=$FOPOST_API_KEY fopost posts create \
  --workspace "$WORKSPACE_ID" \
  --account "$ACCOUNT_ID" \
  --text-file release-notes.md \
  --publish --json --quiet

المفتاح من البيئة

يُقرأ FOPOST_API_KEY تلقائياً. لا خطوة تسجيل دخول في CI.

أي نظام CI

GitHub Actions أو GitLab CI أو أي نظام يشغّل صدفة.

الأتمتة وwebhooks

شغّل الأتمتة وأدر اشتراكات webhook من الأداة نفسها.

أسئلة حول CLI، مع إجاباتها

كيف أثبّت CLI؟

شغّل brew install fopost/tap/fopost، أو go install github.com/fopost/fopost-cli@latest، أو نزّل الأرشيف المناسب لمنصتك من صفحة إصدارات GitHub وضع fopost في PATH.

هل يحتاج إلى حساب؟

نعم. يتواصل CLI مع واجهة FoPost API المستضافة، لذا يحتاج إلى مفتاح API تنشئه من لوحة التحكم عبر الإعدادات، مفاتيح API. يحفظه fopost auth login، أو عيّن FOPOST_API_KEY بدلاً من ذلك.

أين يُخزَّن مفتاح API؟

في مجلد إعدادات المستخدم لديك، ولا يقرأه سواك. لا يعرضه CLI مجدداً أبداً: يعرض auth status بادئة مقنّعة، وتستثنيه المخرجات المفصلة.

ماذا يستطيع أن يفعل؟

المنشورات والحسابات وحالتها، ومساحات العمل، ورفع الوسائط، والتصنيفات، والتحليلات، والأتمتة، وwebhooks. شغّل fopost --help أو اقرأ وثائق CLI لمعرفة كل الأوامر.

هل هو مفتوح المصدر؟

نعم. CLI مرخص بـ MIT وشيفرته المصدرية على GitHub في fopost/fopost-cli.

ابنِ على CLI اليوم

البداية مجانية وواجهة API كاملة مُضمَّنة. أنشئ مفتاحًا ونفّذ أول طلب خلال دقائق.

احصل على مفتاح API