API النشرAPI

طلب POST واحد للنشر في كل مكان

أنشئ المنشور مرة واحدة، وحدّد الحسابات التي يجب أن يصل إليها، ويتولى FoPost التنسيق ورفع الوسائط والتسليم لكل شبكة. مفاتيح محددة الصلاحيات، وطلبات آمنة عند التكرار، وحالة تسليم تستعلم عنها أو تستقبلها عبر webhook.

احصل على مفتاح APIاقرأ الوثائق
POST /v1/posts
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "content": [{ "text": "Shipped a new release today." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

curl -X POST https://api.fopost.com/v1/posts/7d3e0a52-.../publish \
  -H "X-API-Key: $API_KEY"

كل الشبكات بشكل واحد

جسم الطلب نفسه ينشر على X وLinkedIn وInstagram وكل حساب متصل آخر.

مفاتيح محددة الصلاحيات

المفتاح الذي يحمل صلاحية publish ينشر ولا يفعل شيئًا آخر. ألغِه دون المساس بالمفاتيح الأخرى.

تسليم لكل حساب

يُبلغ كل حساب عن حالته ومعرّفه الخارجي ورابطه الدائم بمجرد نشره.

النشر

اكتب المنشور مرة واحدة واستهدف أي مجموعة حسابات

مرّر النص والوسائط والحسابات المستهدفة. يطبّق FoPost حدود كل شبكة وأعرافها، ويرفع الوسائط بالصيغة التي تريدها المنصة، ويُعيد معرّف منشور يمكنك تتبّعه. السلاسل والعروض الدوّارة والنصوص الطويلة كلها تمر عبر مصفوفة المحتوى نفسها.

اقرأ مرجع النشر
الاستجابة
{
  "post_status": "publishing",
  "deliveries": [
    { "id": "a3c5e7f9-...", "account_id": "4a71d80b-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 },
    { "id": "b4d6f8a0-...", "account_id": "c30e9f12-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 }
  ],
  "health_warnings": []
}

كتل المحتوى

تتحول الكتل المرتبة إلى سلسلة أو عرض دوّار أو نص متصل حسب الشبكة.

الوسائط بالإحالة

ارفع مرة واحدة إلى مكتبة الوسائط وأرفق بالمعرّف في أي عدد من المنشورات.

آمن عند التكرار

أرسل مفتاح منع التكرار، فلن يُنشر الطلب المُعاد مرتين أبدًا.

التتبع

اعرف بدقة أين وصل كل منشور

يتفرع المنشور إلى عملية تسليم واحدة لكل حساب. استعلم من نقطة نهاية التسليمات أو اشترك في webhook لتحصل على حالة المنصة والمعرّف الخارجي والرابط الدائم ونص الخطأ حين ترفض شبكة شيئًا.

اطّلع على أحداث webhook
حسابات متصلة عبر كل الشبكات في مساحة عمل واحدة

نقطة نهاية التسليمات

تعرض GET /v1/posts/:id/deliveries كل حساب مع حالته الخاصة.

أحداث webhook

يُطلَق الحدثان delivery.published وdelivery.failed لحظة استقرار نتيجة التسليم.

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

تُعاد محاولة أخطاء المنصات العابرة مع تمهّل متزايد قبل أن تظهر كفشل.

الإدارة

عدّل وألغِ واحذف من الكود

دورة الحياة كاملة متاحة عبر API. حدّث منشورًا مجدولًا قبل نشره، أو ألغِه، أو احذف منشورًا منشورًا من الشبكة التي وصل إليها. وتُبقي التصنيفات ومساحات العمل أعمال العملاء منفصلة حين تدير أكثر من علامة تجارية.

ابدأ البناء
PUT /v1/posts/:id
curl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "content": [{ "text": "Updated copy." }] }'

التعديل قبل النشر

غيّر النص أو الوسائط أو الحسابات في أي منشور ما زال في قائمة الانتظار.

التصنيفات

صنّف المنشورات حسب الحملة أو العميل، وصفِّ كل نقطة نهاية للقوائم حسب التصنيف.

مساحات العمل

المفاتيح خاصة بكل مساحة عمل، فلا يصل عميل إلى عميل آخر أبدًا.

أسئلة حول API النشر، مع إجاباتها

كيف أوثّق طلباتي؟

أنشئ مفتاح API من الإعدادات في لوحة التحكم، ثم أرسله في ترويسة X-API-Key. ينتمي كل مفتاح إلى مساحة عمل واحدة ولا يحمل إلا الصلاحيات التي تمنحه إياها.

على أي شبكات يمكنني النشر؟

على كل حساب متصل بمساحة العمل، عبر كل شبكة يدعمها FoPost. وشكل الطلب واحد لها جميعًا.

هل يمكنني إرفاق صور وفيديو؟

نعم. ارفع الملف مرة واحدة عبر Media API، ثم أشر إلى معرّف الوسائط في المنشور. تُطبَّق حدود الحجم والصيغة لكل شبكة نيابةً عنك.

ماذا يحدث إذا تعطّلت شبكة ما؟

يُعاد التسليم مع تمهّل متزايد. وإذا استمر الفشل، يُعلَّم التسليم بأنه فاشل مع خطأ المنصة، ويُطلَق webhook بالحدث delivery.failed.

هل يوجد حدّ لمعدل الطلبات؟

نعم، 100 طلب في الدقيقة لكل مفتاح. ويُعاد الحد والعدد المتبقي في ترويسات الاستجابة.

هل توجد SDK؟

SDK بلغة TypeScript مع أنواع كاملة، وخادم MCP لعملاء الذكاء الاصطناعي، وحزم مجانية لـ PHP وLaravel وWordPress. وتُقدَّم مواصفات OpenAPI من الواجهة لأي لغة أخرى.

ابنِ على API النشر اليوم

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

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