تحويل الوسائط

تحويل ملفات الوسائط إلى تنسيقات متوافقة مع واتساب (مثلاً إلى OGG/Opus للرسائل الصوتية).

POST

https://api.wawp.net/v2/media/convert?access_token=123456789&file=%7B%22url%22%3A%22https%3A%2F%2Fexample.com%2Faudio.mp3%22%2C%22filename%22%3A%22audio.mp3%22%2C%22mimetype%22%3A%22audio%2Fmpeg%22%7D&instance_id=123456789&outputFormat=ogg

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول

اختبار /v2/media/convert

يدعم

POST

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

حدود الملفات

تحقق من حدود حجم الملف لأنواع الوسائط المختلفة قبل التحميل.

أنواع MIME

تأكد من تحديد نوع MIME الصحيح لملف الوسائط.

توصيات

قم بضغط ملفات الوسائط لتوفير النطاق الترددي وتحسين السرعة.
استخدم تنسيقات متوافقة (مثل MP4 للفيديو، JPEG/PNG للصور).
تعامل مع فشل التحميل مع إعادة المحاولة.

بوابة التحويل: هندسة جودة التنسيق للتوزيع العالمي عبر الهاتف

في عالم الوسائط الرقمية المتنوعة، تعد "التوافقية" هدفاً متحركاً. واجهة تحويل الوسائط هي البنية التحتية المتخصصة في Wawp لسد الفجوة بين ملفاتك الأصلية ومتطلبات واتساب الصارمة للأجهزة المحمولة. من خلال العمل كطبقة توحيد في الوقت الفعلي، تقوم هذه الواجهة بتحويل الإشارات الصوتية والمرئية الخام إلى التنسيقات والترميزات (Codecs) المثالية لشبكة Meta.

🏗️ الفلسفة المعمارية: إلزامية التوحيد القیاسي

لفهم ضرورة هذه الواجهة، يجب أولاً إدراك مشكلة "الرفض الصامت" في المراسلة. إذا أرسلت شركة ملفاً غير محسن، فقد يستلمه العميل كـ "مرفق عام" بدلاً من كائن وسائط تفاعلي يمكن تشغيله مباشرة.

1. لغز الأوبوس (Opus) والرسائل الصوتية

تتم معالجة ملفات MP3 القياسية بواسطة واتساب كـ "ملفات صوتية" تتطلب التحميل قبل التشغيل وتظهر بأيقونة عامة. ولكن، إذا تم تحويلها إلى تنسيق OGG بترميز Opus، يتعرف عليها واتساب كـ "رسالة صوتية" (Voice Note)، مما يخلق تجربة الميكروفون الأزرق المميزة التي تتيح التشغيل الفوري والتحكم في السرعة.

2. موازنة جودة الفيديو

إرسال فيديو بدقة 4K لمستخدم على جهاز متواضع قد يؤدي لتجربة سيئة. توفر "بوابة التحويل" ضغطاً استراتيجياً يحافظ على الجودة البصرية مع تحسين حجم الملف لسرعة النقل على الأجهزة المحمولة.

🚀 حالات الاستخدام الاستراتيجي: تمكين تدفقات الوسائط المؤتمتة

1. "البوت البشري" (أتمتة الرسائل الصوتية)

يمكن لبوت الدعم الرد برسالة صوتية: "مرحباً! تم استلام طلبك. هل هناك شيء آخر؟". لتحقيق ذلك، يتم توليد الصوت من محرك تحويل النص إلى كلام (TTS)، ثم استخدام واجهة تحويل الوسائط لجعله رسالة صوتية أصلية، مما يضيف لمسة إنسانية للأتمتة.

2. التروية المحمية والتطهير (Sanitization)

غالباً ما يتم إخفاء الملفات الضارة كملفات وسائط. من خلال تمرير كل صورة أو مستند يرفعه المستخدم عبر عملية تحويل، يتم "تطهير" الملف؛ حيث تعيد عملية إعادة الترميز بناء البيانات الثنائية من الصفر وتجردها من البيانات الوصفية غير الضرورية (مثل EXIF)، مما يخلق "جدار حماية منطقي" لبيانات شركتك.

🛡️ أفضل الممارسات الهندسية والتشغيلية

التخزين المؤقت للوسائط المحولة: تحويل الوسائط عملية محددة النتائج. إذا قمت بتحويل ملف فيديو ترحيبي مرة واحدة، قم بتخزين رابط النسخة المحولة في قاعدة بياناتك وأعد استخدامه بدلاً من إعادة التحويل لكل مستخدم لتوفير الوقت والتكلفة.
إدارة أبعاد الصورة (Aspect Ratios): يفضل واتساب أبعاداً معينة (مثل 1:1 لصور الملف الشخصي، و 9:16 للحالات). استخدم منطق التحويل لضمان عدم ظهور محتواك بشكل مشوه أو ممتد.
سياسة التنسيق أولاً: تحقق دائماً من البيانات الوصفية للملف المصدر. إذا كان الملف متوافقاً بالفعل، تخطَّ عملية التحويل لتوفير الموارد.

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

محتوى الطلب

يرسل كـ JSON

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`object`		File to convert (URL, filename, mimetype) مثال:
	`string`		Desired output format (ogg, mp4, etc.) مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/media/convert";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7const body = {
8  "file": {
9    "url": "https://example.com/audio.mp3",
10    "filename": "audio.mp3",
11    "mimetype": "audio/mpeg"
12  },
13  "outputFormat": "ogg"
14};
15
16fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
17  method: "POST",
18  headers: { "Content-Type": "application/json" },
19  body: JSON.stringify(body)
20})
21  .then(async (response) => {
22    if (response.ok) {
23      const data = await response.json();
24      console.log("Success:", data);
25      return data;
26    }
27    
28    // Error Handling
29    if (response.status === 400) {
30      console.error("Error 400: طلب غير صالح - معاملات مطلوبة مفقودة");
31    }
32    if (response.status === 400) {
33      console.error("Error 400: طلب غير صالح (تنسيق XML)");
34    }
35    if (response.status === 400) {
36      console.error("Error 400: طلب غير صالح (نص عادي)");
37    }
38    if (response.status === 401) {
39      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
40    }
41    if (response.status === 401) {
42      console.error("Error 401: غير مصرح (تنسيق XML)");
43    }
44    if (response.status === 404) {
45      console.error("Error 404: غير موجود - الجلسة غير موجودة");
46    }
47    if (response.status === 404) {
48      console.error("Error 404: غير موجود (تنسيق XML)");
49    }
50    if (response.status === 500) {
51      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
52    }
53    if (response.status === 500) {
54      console.error("Error 500: خطأ في الخادم الداخلي (HTML)");
55    }
56    if (response.status === 502) {
57      console.error("Error 502: بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي");
58    }
59    if (response.status === 502) {
60      console.error("Error 502: بوابة غير صالحة (تنسيق XML)");
61    }
62
63    const errorText = await response.text();
64    console.error(`Error ${response.status}: ${errorText}`);
65  })
66  .catch((error) => console.error("Network Error:", error));

عينات تفاعليةUTF-8

Ln 66, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Media converted successfully

4 نسخ

النوع:

السيناريو:

application/json

string *

Example

{
"url": "https://wawp.net/media/converted.ogg",
"filename": "converted.ogg",
"mimetype": "audio/ogg; codecs=opus"
}

طلب غير صالح - معاملات مطلوبة مفقودة

3 نسخ

غير مصرح - مفتاح الوصول غير صالح أو مفقود

2 نسخ

Command Palette

Search for a command to run...