الوسائط

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

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

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

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

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

التفويضات

Authorizationstringمطلوب

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

يبقى في هذا التبويب فقط، ويُرسل إلى api.sofia-post.com فقط. احصل على مفتاح API

الترويسات

Idempotency-Keystring

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

الجسم

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

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

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"}'

{
  "id": "string",
  "type": "image",
  "url": "string"
}

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

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

{
  "id": "string",
  "type": "image",
  "url": "string"
}

الاستيراد من عنوان URL

أرسل JSON مع establishmentId وurl عام بـ https. تنزّل Sofia الملف بنفسها وتفحصه وتضعه في مكتبة الوسائط.

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

رفع ملف

أو أرسل الملف نفسه بصيغة multipart/form-data، مع حقل file.

curl -X POST https://api.sofia-post.com/api/v1/media \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -F establishmentId=$ESTABLISHMENT_ID \
  -F file=@tatin.jpg

{
  "id": "393d5aa4-16f1-430f-b1d8-1fb1473076ef",
  "type": "image",
  "url": "https://…/393d5aa4-16f1-430f-b1d8-1fb1473076ef.jpg?X-Amz-…"
}

ما هو مقبول

صور وفيديو، حتى 200 ميغابايت.
يجب أن يكون عنوان URL عامًا بـ https: يُرفض عنوان خاص، أو أكثر من 3 عمليات تحويل، أو تنزيل يتجاوز 30 ثانية.
url المُعاد موقّع وتنتهي صلاحيته: احتفظ بـ id، وأعد قراءة الوسيط بـ GET /v1/media/{id} حين تحتاج إلى عنوان URL جديد.

الملف المرفوض يرد بـ 422 media_import_refused أو media_upload_refused، مع السبب في details والخطوات المتبعة في message.

التفويضات

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

الترويسات

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

الجسم

application/json, multipart/form-data

establishmentIdstringمطلوب
المنشأة التي تستلم مكتبة وسائطها الوسائط
urlstring
JSON: عنوان https للوسائط، تجلبه Sofia بنفسها (دون ملف)
filestring<binary>
multipart/form-data: الملف (صورة أو فيديو)، دون url

الاستجابة

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

idstringمطلوب
معرّف الوسائط، لتمريره في media[].id لمنشور
typestringمطلوب
نوع الوسائط
القيم المسموحة: imagevideo
urlstringمطلوب
عنوان موقّع، صالح للنافذة الحالية

هل كانت هذه الصفحة مفيدة؟