الوسائط

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

نقاط النهاية

POST/v1/mediaGET/v1/mediaGET/v1/media/{id}DELETE/v1/media/{id}

الاستيراد من رابط URL

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

bash
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.

bash
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
json
{
  "id": "393d5aa4-16f1-430f-b1d8-1fb1473076ef",
  "type": "image",
  "url": "https://…/393d5aa4-16f1-430f-b1d8-1fb1473076ef.jpg?X-Amz-…"
}

ما هو المقبول

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

الملف المرفوض يُجاب بـ 422 media_import_refused أو media_upload_refused، مع السبب في details وما يجب فعله في message.