Media APIAPI

ارفع مرة واحدة، وانشر في أي مكان

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

احصل على مفتاح APIاقرأ الوثائق
POST /v1/media/upload
curl -X POST "https://api.fopost.com/v1/media/upload?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY" \
  -F "[email protected]"

{
  "data": [
    {
      "id": "e5a1c9d4-...",
      "type": "image",
      "name": "launch.png",
      "url": "https://.../launch.png",
      "preview_url": "https://api.fopost.com/v1/media/e5a1c9d4-.../file",
      "size": 412883
    }
  ]
}

رفع متعدد الأجزاء

صور وفيديو حتى 50 MB، يُتحقق منها بالمحتوى لا بالامتداد فقط.

إعادة الاستخدام بالمعرّف

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

خاص افتراضيًا

تُحفظ الملفات في تخزين خاص ولا تُقدَّم إلا لأعضاء مساحة العمل.

الرفع

طريق واحد للدخول، مع فحص عند الوصول

يمر كل ملف بالمسار نفسه: قائمة أنواع MIME المسموح بها، وفحص للبايتات الفعلية، وحد أقصى للحجم، وحصة التخزين المجانية لحسابك. وما يعود إليك صف في المكتبة بنوعه وحجمه، جاهز للإرفاق.

اقرأ مرجع الوسائط
الإرفاق بمنشور
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": "Launch day.", "media": [{ "type": "image", "name": "launch.png", "url": "https://.../launch.png" }] }],
    "accounts": ["4a71d80b-..."]
  }'

الصور

PNG وJPEG وGIF وWebP، مع قراءة النوع والحجم عند الرفع.

الفيديو

MP4 وMOV، مع فحص المدة والحجم وفق كل شبكة وقت النشر.

مُتحقَّق منه

يجب أن يطابق المحتوى الفعلي للملف نوعه، وإلا يُرفض الرفع.

التسليم

الصيغة الصحيحة لكل شبكة، نتولاها عنك

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

اطّلع على آلية التسليم
صور العلامة التجارية منظمة في مكتبة الوسائط المشتركة

قواعد لكل شبكة

يطبّق المحوّل حدود الحجم والصيغة، لا أنت.

وسائط مرتبة

الترتيب في كتلة المحتوى هو ترتيب العرض الدوّار.

أسباب فشل واضحة

الملف الذي لا تقبله شبكة يُفشل ذلك التسليم مع ذكر السبب، لا المنشور بأكمله.

الإدارة

تصفّح المكتبة واجلب منها وأعد الاستخدام

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

ابدأ البناء
GET /v1/media
curl "https://api.fopost.com/v1/media?workspace_id=9b2f6c1e-...&type=image" \
  -H "X-API-Key: $API_KEY"

# Fetch the file itself
curl -L "https://api.fopost.com/v1/media/e5a1c9d4-.../file" \
  -H "X-API-Key: $API_KEY" -o launch.png

العرض والتصفية

حسب النوع أو المصدر أو دور العلامة التجارية، مع تقسيم إلى صفحات.

رابط ملف ثابت

/v1/media/:id/file always works for members; no signed links to refresh.

محصور في مساحة العمل

يرى المفتاح مكتبة مساحة عمل واحدة ولا شيء غيرها.

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

ما حد الحجم؟

50 MB لكل ملف. ولكل شبكة حدودها القصوى الخاصة، ويُتحقق منها حين يُسلَّم المنشور إلى تلك الشبكة.

ما الصيغ المقبولة؟

صيغ الصور الشائعة (PNG وJPEG وGIF وWebP) والفيديو (MP4 وMOV). يفحص الرفع البايتات الفعلية للملف، فيُرفض الملف الذي غُيّر اسمه.

هل يمكنني إرفاق معرّف وسائط بأكثر من منشور؟

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

هل الملفات المرفوعة عامة؟

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

هل يُحتسب من حصة ما؟

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

هل يمكنني الاستيراد من رابط أو من أداة تصميم؟

نعم، تصل الملفات المستوردة إلى المكتبة نفسها وتحمل مرجعًا لمصدرها، فتعيد جلب التصميم المحدَّث في مكانه بدلًا من رفع ملف جديد.

ابنِ على Media API اليوم

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

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