الوسائطارفع وسائط أو استوردها
العودة إلى Sofia

الوسائط

ارفع وسائط أو استوردها

يضيف ملفًا (multipart) أو رابط https تجلبه Sofia إلى مكتبة وسائط منشأة. يتطلب تطبيقًا فعليًا واشتراكًا نشطًا للحساب.

POSThttps://api.sofia-post.com/api/v1/media
POST/v1/media

يؤثر هذا الطلب على حسابك الحقيقي.

curl -X POST 'https://api.sofia-post.com/api/v1/media' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"establishmentId":"string","url":"https://cdn.example.com/tarte-tatin.jpg"}'

التفويضات

  • Authorizationstringمطلوب

    مفتاحك الشخصي أو رمز وصول OAuth، يُرسل كـ Bearer <token>.

الترويسات

  • Idempotency-Keystring

    عند إعادة الطلب بالجسم نفسه يعيد الاستجابة نفسها دون استيراد ثانٍ. يشمل حقول النموذج لا بايتات الملف.

الجسم

application/json, multipart/form-data

  • establishmentIdstringمطلوب

    المنشأة التي تستلم مكتبة وسائطها الوسائط

  • urlstring

    JSON: عنوان https للوسائط، تجلبه Sofia بنفسها (دون ملف)

  • filestring<binary>

    multipart/form-data: الملف (صورة أو فيديو)، دون url

الاستجابة

201application/json

الوسائط المضافة إلى المكتبة.

  • idstringمطلوب

    معرّف الوسائط، لتمريره في media[].id لمنشور

  • typestringمطلوب

    نوع الوسائط

    القيم المسموحة: imagevideo

  • urlstringمطلوب

    عنوان موقّع، صالح للنافذة الحالية

400

جسم مشوّه.

401

الرمز مفقود أو غير معروف أو منتهي الصلاحية أو ملغى.

402

subscription_required.

403

live_mode_required لتطبيق اختباري، أو أن النطاق media:write مفقود.

404

منشأة خارج مساحة عمل الرمز.

413

payload_too_large: يتجاوز حد حجم التطبيق.

422

media_import_refused، مع سببه: private_address أو too_large أو unsupported_media أو unreachable أو timeout أو invalid_url أو redirect_limit أو removed_from_library. media_upload_refused لملف.

4XXapplication/json

أي خطأ آخر، ضمن غلاف الخطأ.