انتقل للمحتوى

    عربي أو إنجليزي · ↑↓ للتنقل · Enter للفتح · Esc للقفل

    English
    في الصفحة دي

    الرسايل

    ارفع الميديا مرة وابعتها كذا مرة

    POST/v2/media
    • الصلاحية:messages:send
    • Idempotency-Key:اختياري
    • مفتاح الرقم شغال— بيقبل كمان مفتاح x-api-key القديم الخاص بالرقم، لنفس الرقم.
    • بيصرف رصيد

    بيرجع media id صالح 24 ساعة على نفس الرقم. بيقبل كمان JSON فيه url.

    البارامترات

    الهيدرز

    الاسمالنوعالقيودالوصف
    Idempotency-Keyاختياريالنوعstringالقيود≤ 191 حرفالوصفid فريد من عندك للعملية دي (حد أقصى 191 حرف ASCII). لو كررت بنفس المفتاح ونفس الـ body بيرجعلك أول رد ومعاه Idempotent-Replayed: true — عمرها ما تتنفذ مرتين. بيتحفظ 24 ساعة.
    X-Request-Idاختياريالنوعstringالقيود—الوصفاختياري: id الطلب بتاعك وبيرجعلك (غير كده بنعمل req_…). اديه للدعم لو احتجت.

    حقول multipart/form-data

    الاسمالنوعالقيودالوصف
    numberIdاختياريالنوعstringالقيود—الوصفالرقم اللي هيبعت الملف — الملف المرفوع يستخدمه الرقم ده بس، لمدة 24 ساعة.
    fileاختياريالنوعfileالقيود—الوصفالملف نفسه (multipart). نوعه الحقيقي بيتعرف من محتواه؛ اسم الملف مش بيتاخد بيه.

    الطلب

    curl -X POST "https://mursilat.com/api/v2/media" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm" \
      -F numberId="cm1abcd2345efgh6789ijkl" \
      -F file=@logo.png

    الرد

    200مثال

    200 — application/json
    {
      "mediaId": "med_8f2c1d9a7b3e4f56a1b2c3d4",
      "mimeType": "image/png",
      "size": 48213,
      "fileName": "logo.png",
      "expiresAt": "2026-10-14T08:00:00.000Z",
      "numberId": "cm1abcd2345efgh6789ijkl"
    }

    شكل الرد

    حقول الرد في المثال. افتح الكائنات والقوايم.

    • responseobject6 حقل
      • mediaIdstring "med_8f2c1d9a7b3e4f56a1b2c3d4"
      • mimeTypestring "image/png"
      • sizeinteger 48213
      • fileNamestring "logo.png"
      • expiresAtstring "2026-10-14T08:00:00.000Z"
      • numberIdstring "cm1abcd2345efgh6789ijkl"

    الأخطاء

    غير أخطاء المصادقة وحدود الطلبات والتحقق اللي ممكن ترجع من أي endpoint:

    الأخطاء →

    جرّب

    ابعت الطلب ده من متصفحك لـ API مرسلات.

    مثال موثّق

    معاينة — النسخة دي من التوثيق مش على mursilat.com، فالكونسول بيعرض المثال الموثّق بدل ما يكلم الـ API.

    الطلبات الحقيقية بتستخدم رقمك وباقتك الحقيقيين: ممكن تبعت رسايل واتساب وتصرف من رصيدك وتمسح بيانات. (بيصرف رصيد)

    متخزن في ذاكرة التبويب ده بس: عمره ما بيتحفظ ولا بيتحط في الرابط، وبيتبعت لـ mursilat.com بس. لو عملت reload بيتنسي.

    multipart/form-data → curl
    نفس الطلب بـ curl
    curl -X POST 'https://mursilat.com/api/v2/media' \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H 'Accept: application/json'

    تبعت الطلب ده بجد؟

    ده بيصرف من رصيد باقتك.

    POST https://mursilat.com/api/v2/media