رفع صورة واتساب
قم برفع صورة ملف شخصي جديدة لحساب واتساب الخاص بك.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
استخدم شعارًا عالي التباين يكون مرئيًا في الصور المصغرة.
قم بتحديث صورتك للعطلات أو الحملات الخاصة.
الهوية البصرية: إتقان صورة الملف الشخصي
صورة ملفك الشخصي هي أول ما يراه المستخدمون عندما يتلقون إشعاراً منك. الشعار الاحترافي عالي الدقة يبني ثقة فورية. تسمح لك نقطة النهاية /v2/profile/picture بتحديث هذا الأصل برمجياً، مما يتيح استراتيجيات علامة تجارية ديناميكية (على سبيل المثال، "شعارات الأعياد").
🏗️ المتطلبات التقنية وإرشادات الأصول
لضمان ظهور علامتك التجارية بشكل واضح على جميع الأجهزة، التزم بهذه المواصفات الصارمة:
- التنسيق: JPEG هو التنسيق الأصلي لواتساب. ملفات PNG مدعومة ولكن سيتم تحويلها، مما يؤدي غالباً إلى زيادة حجم الملف أو تغييرات طفيفة في الألوان.
- الأبعاد:
- الحد الأدنى: 192x192 بكسل.
- الموصى به: 640x640 بكسل أو أعلى.
- نسبة العرض إلى الارتفاع: 1:1 (مربع) حصرياً. سيتم قص الصور غير المربعة من المركز أو رفضها.
- حجم الملف: حافظ على حجم الرفع أقل من 2 ميجابايت.
🚀 تحذير "المنطقة الآمنة"
يطبق واتساب قناعاً دائرياً على صورتك المربعة في قائمة الدردشة وشريط الإشعارات.
- الخطر: إذا وضعت نصاً أو شعارات في زوايا صورتك المربعة، فسيتم قصها.
- الحل: عامل الدائرة المركزية بنسبة 70% كـ "منطقة آمنة". تأكد من أن أيقونة شعارك متمركزة تماماً ولديها مساحة كافية (مساحة سلبية) حولها.
🛡️ سلوك المزامنة
- سرعة الانتشار: على عكس الرسائل التي تصل فوراً، تنتقل صور الملف الشخصي عبر بنية تحتية مختلفة لـ CDN. قد يستغرق الأمر ما يصل إلى 5 دقائق لتظهر صورتك الجديدة على جميع أجهزة عملائك.
- إعدادات الخصوصية: يحترم API قواعد الخصوصية العالمية لجهازك. لخطوط الأعمال، اضبط هذا دائماً على "الجميع".
⚠️ اعتبارات هامة
- إمكانية الوصول للرابط: يجب أن يكون الرابط
file[url]الذي تقدمه متاحاً للجمهور. يحتاج محرك Wawp إلى تنزيل الصورة من هذا الرابط قبل إعادة رفعها إلى واتساب. - حدود المعدل: تغيير صورتك بشكل متكرر (على سبيل المثال، كل دقيقة) سيؤدي إلى حظر سبام. حدد التحديثات بحد أقصى 5 مرات في اليوم.
- الحذف مقابل الاستبدال: لست بحاجة إلى حذف الصورة القديمة قبل رفع واحدة جديدة. الرفع الجديد يستبدل الأصل الحالي تلقائياً.
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
محتوى الطلب
يرسل كـ JSONstring | WhatsApp Instance ID مثال: | ||
string | API Access Token مثال: | ||
string | رابط مباشر للصورة مثال: | ||
string | اسم الملف مثال: | ||
string | نوع MIME للصورة (يوصى بـ image/jpeg) مثال: |
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"success": true,
"message": "Operation completed successfully"
}Command Palette
Search for a command to run...