حالة صورة

انشر حالة صورة (قصة) على واتساب.

POST
https://api.wawp.net/v2/status/image?access_token=YOUR_ACCESS_TOKEN&caption=Check+our+new+menu%21&file%5Bfilename%5D=image.jpg&file%5Bmimetype%5D=image%2Fjpeg&file%5Burl%5D=https%3A%2F%2Fwawp.net%2Fsamples%2Fcat.jpg&instance_id=123456789

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

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

تسجيل الدخول
اختبار /v2/status/image
POST
POST

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

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

توصيات

  • انشر إعلانات تشويقية للمنتج أو عروض لفترة محدودة.

  • استخدم التسميات التوضيحية لإضافة سياق إلى الصورة.

السرد القصصي البصري: حالة الصورة

تعد نقطة النهاية /v2/status/image أداة التواصل البصري عالية الدقة. على عكس المنصات الأخرى، تحافظ حالة واتساب على جودة الملف الأصلي بشكل كبير إذا التزمت بالمواصفات الصحيحة.


📐 النسبة الذهبية: 9:16

حالة واتساب هي تجربة ملء الشاشة للهواتف المحمولة أولاً.

  • الدقة المستهدفة: 1080x1920 بكسل.
  • لماذا؟: هذه الدقة تملأ شاشة معظم الهواتف الحديثة تماماً دون أشرطة سوداء.
  • مناطق الأمان:
    • الأعلى (100 بكسل): محجوز لشريط التقدم واسم الملف الشخصي.
    • الأسفل (150 بكسل): محجوز لسهم الرد وتراكب التعليق.
  • الاستراتيجية: حافظ على النصوص والشعارات المهمة في الوسط (1080x1670 بكسل) لتجنب تغطيتها بعناصر الواجهة.

🎨 جودة الصورة والضغط

واتساب وقح في ضغط الصور لتوفير البيانات لملياري مستخدم.

  • المحرك: يستخدم واتساب مشفر JPEG يقوم بإزالة البيانات الميتا ويقلل الجودة إلى ~70%.
  • التحسين المسبق:
    • افعل: ارفع صوراً محسنة بالفعل (مثلاً باستخدام TinyJPG).
    • لا تفعل: ترسل صوراً مشوشة؛ فآثار الضغط ستظهر بشكل أكبر على الشاشات عالية الدقة.
  • التنسيق: استخدم JPEG أو PNG.

📝 التعليقات: الخطاف الخفي

حقل caption ليس مجرد نص بديل؛ بل هو تراكب تفاعلي.

  • الظهور: يظهر في أسفل الشاشة.
  • السلوك: إذا كان التعليق طويلاً، فسيتم اقتطاعه. أي شيء يتجاوز 100 حرف سيتطلب من المستخدم الضغط على "قراءة المزيد".
  • الاستراتيجية: استخدم التعليق لـ طلب إجراء (CTA).
    • مثال: "اضغط على رد للحصول على جدول المقاسات! 👇"

🚀 التنفيذ الاستراتيجي

1. تأثير "الكاروسيل" (Carousel)

يمكنك نشر عدة صور بتتابع سريع لإنشاء عرض شرائح.

  • الطريقة: استدعِ الواجهة 3 مرات مع تأخير 0.5 ثانية بين الاستدعاءات.

2. حيلة رمز QR

بما أنه لا يمكنك وضع رابط قابل للنقر على الصورة نفسها، يقوم البعض بدمج رمز QR في تصميم الصورة.

  • الإجراء: "خذ لقطة شاشة لمسح الرمز لاحقاً!"

🧩 ملاحظات البروتوكول

انتهاء الصلاحية

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

البارامترات

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

محتوى الطلب

يرسل كـ JSON
string

WhatsApp Instance ID

مثال:
string

API Access Token

مثال:
string

رابط مباشر للصورة

مثال:
string

اسم الملف

مثال:
string

نوع MIME للصورة

مثال:
string

تعليق نصي للصورة

مثال:

أمثلة الكود

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

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

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

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

ناجح - تم إكمال الطلب بنجاح
النوع:
application/json
boolean *
string *

Example

{
"success": true,
"message": "Operation completed successfully"
}
طلب غير صالح - معاملات مطلوبة مفقودة
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي
الموضوع السابقحالة نصية
الموضوع التاليحالة صوتية

Command Palette

Search for a command to run...