API الجدولةAPI

جدول منشورًا بحقل واحد

أرسل الجسم نفسه الذي كنت ستنشره الآن، وأضف طابعًا زمنيًا في schedule_at، ويحتفظ به FoPost في قائمة الانتظار حتى ذلك الوقت. يبقى كل شيء قابلًا للتعديل حتى لحظة النشر، ويُبلَّغ عن التسليم لكل حساب.

احصل على مفتاح 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-...",
    "status": "scheduled",
    "schedule_at": "2026-09-01T09:00:00Z",
    "content": [{ "text": "Webhook retries are live. Read the changelog." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

طابع زمني واحد

أي وقت مستقبلي بصيغة ISO 8601. تلتقطه قائمة الانتظار وتنشره في موعده.

قابل للتعديل حتى الإرسال

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

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

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

قائمة الانتظار

خطّط منشورات أسبوع كامل في سكربت واحد

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

اقرأ مرجع المنشورات
GET /v1/posts?status=scheduled
curl "https://api.fopost.com/v1/posts?workspace_id=9b2f6c1e-...&status=scheduled" \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    { "id": "7d3e0a52-...", "status": "scheduled", "schedule_at": "2026-09-01T09:00:00Z", "accounts": [{ "id": "4a71d80b-...", "platform": "linkedin", "publish_status": "pending" }] },
    { "id": "8e4f1b63-...", "status": "scheduled", "schedule_at": "2026-09-02T09:00:00Z", "accounts": [{ "id": "c30e9f12-...", "platform": "twitter", "publish_status": "pending" }] }
  ],
  "meta": { "page": 1, "per_page": 30, "total": 2, "total_pages": 1 }
}

التصفية حسب الحالة

اعرض المسودات أو المنشورات المجدولة أو المنشورة أو الفاشلة بمعامل استعلام واحد.

التصنيفات

صنّف كل منشور حسب الحملة وصفِّ قائمة الانتظار حسب التصنيف.

لكل مساحة عمل

يرى المفتاح مساحة عمل واحدة، فلا تختلط قائمة انتظار عميل بقائمة عميل آخر أبدًا.

التعديل

انقل أو أعد الكتابة أو ألغِ قبل النشر

الخطط تتغير. أرسل PUT إلى منشور مجدول لتغيير وقته أو نصه أو وسائطه أو الحسابات المستهدفة. ألغِه فيُعلَّم كملغى ولا يُسلَّم أبدًا، أو احذفه نهائيًا. لا شيء يُقفل حتى تلتقطه قائمة الانتظار.

اطّلع على نقطة نهاية PUT
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 '{ "schedule_at": "2026-09-01T14:00:00Z" }'

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

غيّر schedule_at فتنقل قائمة الانتظار المنشور إلى الوقت الجديد.

استبدال المحتوى

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

الإلغاء أو الحذف

اسحب منشورًا من قائمة الانتظار دون المساس بأي شيء آخر فيها.

التأكيد

اعرف متى وصل المنشور، دون استعلام متكرر

عند حلول الوقت المجدول، يتفرع المنشور إلى عملية تسليم واحدة لكل حساب. سجّل webhook فيُطلَق delivery.published أو delivery.failed لكل واحدة، أو استعلم من نقطة نهاية التسليمات إن كنت تفضّل نموذج السحب.

ابدأ البناء
شهر من المنشورات المجدولة على تقويم النشر

Webhook عند الاستقرار

يحمل delivery.published معرّف المنشور والحساب والرابط الدائم.

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

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

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

بعد النشر، يقرأ معرّف المنشور نفسه مرات الظهور والتفاعل من Analytics API.

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

إلى أي مدى مسبقًا يمكنني الجدولة؟

إلى المدى الذي تريده. يُقبل أي طابع زمني مستقبلي بصيغة ISO 8601، وتحتفظ قائمة الانتظار بالمنشور حتى موعده.

ما المنطقة الزمنية التي يستخدمها schedule_at؟

أرسل طابعًا زمنيًا بصيغة ISO 8601 بتوقيت UTC ينتهي بـ Z. القيمة التي ترسلها هي القيمة التي تُنفَّذ، ولا يحدث أي تحويل على الخادم.

هل يمكنني تعديل منشور بعد جدولته؟

نعم. أرسل PUT لأي حقل، بما فيه الوقت، في منشور لم يُنشر بعد. وبعد نشره، تنطبق التعديلات على السجل، وتستخدم الحذف لإزالته من الشبكة.

ماذا يحدث إذا كان خادمي متوقفًا وقت النشر؟

لا شيء يتغير. تعمل قائمة الانتظار داخل FoPost لا على بنيتك التحتية، فيُنشر المنشور سواء كانت عمليتك تعمل أم لا.

هل يمكنني الجدولة لجزء من الحسابات فقط؟

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

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

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

ابنِ على API الجدولة اليوم

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

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