تخطَّ إلى المحتوى
ساعيv1

الوسائط

عرض بصيغة Markdown

ارفع الملفات مرة واحدة وأرسلها متى شئت.

نقاط الواجهة

عرض الملفات

gethttps://api.saei.automize.sa/v1/media
  • الصلاحية: media:read
  • يعمل في وضع الاختبار

معاملات الاستعلام

  • limitintegerاختياري

    عدد العناصر المطلوبة، من 1 إلى 100.

  • cursorstringاختياري

    قيمة next_cursor من الصفحة السابقة.

  • typestringاختياري

    إحدى القيمimagevideoaudiodocumentsticker

حقول الاستجابة200
  • object"list"مطلوب
  • dataarray<Media>مطلوب
    الحقول الفرعية (8)
    • idstringمطلوب
    • object"media"مطلوب
    • typestringمطلوب

      إحدى القيمimagevideoaudiodocumentsticker

    • filenamestring | nullاختياري
    • mime_typestring | nullاختياري
    • size_bytesintegerمطلوب
    • urlstringمطلوب

      رابط عام دائم يصعب تخمينه. يستطيع أي شخص يملكه فتح الملف.

    • created_atstring | nullاختياري
  • has_morebooleanمطلوب
  • next_cursorstring | nullمطلوب
الأخطاء المحتملة2
جرّبها
curl -X GET https://api.saei.automize.sa/v1/media \
  -H "Authorization: Bearer $API_KEY"
الاستجابة

صفحة من الملفات.

{
  "object": "list",
  "data": [
    {
      "id": "med_381",
      "object": "media",
      "type": "image",
      "filename": "string",
      "mime_type": "string",
      "size_bytes": 0,
      "url": "string",
      "created_at": "2026-10-01T09:30:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": "string"
}

رفع ملف

posthttps://api.saei.automize.sa/v1/media
  • الصلاحية: media:write
  • يعمل في وضع الاختبار
  • يقبل Idempotency-Key

يضيف ملفًا إلى مكتبة الوسائط في مساحة العمل ويمنحه رابطًا عامًا دائمًا. أرسل id الخاص به في حقل media_id لرسالة image أو video أو audio أو document أو sticker، مهما تكرر ذلك.

أرسل الملف بصيغة multipart/form-data مع type الذي سيُرسل به. تُفحص حدود واتساب هنا قبل أي إرسال: الصور JPEG/PNG حتى 5 ميجابايت، الفيديو MP4/3GPP حتى 16 ميجابايت، الصوت حتى 16 ميجابايت، المستندات حتى 100 ميجابايت، الملصقات WebP حتى 100 كيلوبايت (500 للمتحركة).

الترويسات

  • Idempotency-Keystringاختياري

    أي نص فريد (يُفضّل UUID). إعادة الطلب بنفس المفتاح ونفس الجسم تُرجع الاستجابة الأولى بدل التنفيذ مرتين. يُحفظ لمدة 24 ساعة.

جسم الطلب

  • filestringمطلوب
  • typestringمطلوب

    إحدى القيمimagevideoaudiodocumentsticker

حقول الاستجابة201
  • idstringمطلوب
  • object"media"مطلوب
  • typestringمطلوب

    إحدى القيمimagevideoaudiodocumentsticker

  • filenamestring | nullاختياري
  • mime_typestring | nullاختياري
  • size_bytesintegerمطلوب
  • urlstringمطلوب

    رابط عام دائم يصعب تخمينه. يستطيع أي شخص يملكه فتح الملف.

  • created_atstring | nullاختياري
الأخطاء المحتملة6
جرّبها
curl -X POST https://api.saei.automize.sa/v1/media \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "file=@photo.jpg" \
  -F "type=image"
الاستجابة

تم الرفع.

{
  "id": "med_381",
  "object": "media",
  "type": "image",
  "filename": "shoe-front.png",
  "mime_type": "image/png",
  "size_bytes": 482113,
  "url": "https://api.example.com/media/3f9a0c1b2d4e5f60718293a4b5c6d7e8f9012345/shoe-front.png",
  "created_at": "2026-10-01T09:00:00Z"
}

جلب ملف

gethttps://api.saei.automize.sa/v1/media/{id}
  • الصلاحية: media:read
  • يعمل في وضع الاختبار

معاملات المسار

  • idstringمطلوب

    معرّف العنصر.

حقول الاستجابة200
  • idstringمطلوب
  • object"media"مطلوب
  • typestringمطلوب

    إحدى القيمimagevideoaudiodocumentsticker

  • filenamestring | nullاختياري
  • mime_typestring | nullاختياري
  • size_bytesintegerمطلوب
  • urlstringمطلوب

    رابط عام دائم يصعب تخمينه. يستطيع أي شخص يملكه فتح الملف.

  • created_atstring | nullاختياري
الأخطاء المحتملة2
جرّبها
curl -X GET https://api.saei.automize.sa/v1/media/med_381 \
  -H "Authorization: Bearer $API_KEY"
الاستجابة

تفاصيل الملف ورابطه العام.

{
  "id": "med_381",
  "object": "media",
  "type": "image",
  "filename": "string",
  "mime_type": "string",
  "size_bytes": 0,
  "url": "string",
  "created_at": "2026-10-01T09:30:00Z"
}

حذف ملف

deletehttps://api.saei.automize.sa/v1/media/{id}
  • الصلاحية: media:write
  • لمفاتيح التشغيل فقط

يحذف الملف ورابطه العام فورًا. إن كانت رسائل محفوظة أو قوالب ما زالت تستخدمه فالرد هو resource_in_use مع قائمتها؛ أضف ?force=true للحذف رغم ذلك. يحتاج مفتاحًا حيًّا لأن المكتبة هي مكتبتك الحية.

معاملات المسار

  • idstringمطلوب

    معرّف العنصر.

معاملات الاستعلام

  • forcebooleanاختياري
حقول الاستجابة200
  • idstringمطلوب
  • objectstringمطلوب
  • deletedtrueمطلوب
الأخطاء المحتملة4
جرّبها
curl -X DELETE https://api.saei.automize.sa/v1/media/med_381 \
  -H "Authorization: Bearer $API_KEY"
الاستجابة

تم الحذف.

{
  "id": "med_381",
  "object": "media",
  "deleted": true
}