رفع صورة واتساب

قم برفع صورة ملف شخصي جديدة لحساب واتساب الخاص بك.

PUT
https://api.wawp.net/v2/profile/picture?access_token=YOUR_ACCESS_TOKEN&file%5Bfilename%5D=logo.jpg&file%5Bmimetype%5D=image%2Fjpeg&file%5Burl%5D=https%3A%2F%2Fwawp.net%2Flogo.jpg&instance_id=123456789

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

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

تسجيل الدخول
اختبار /v2/profile/picture
PUT
PUT

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

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

توصيات

  • استخدم شعارًا عالي التباين يكون مرئيًا في الصور المصغرة.

  • قم بتحديث صورتك للعطلات أو الحملات الخاصة.

الهوية البصرية: إتقان صورة الملف الشخصي

صورة ملفك الشخصي هي أول ما يراه المستخدمون عندما يتلقون إشعاراً منك. الشعار الاحترافي عالي الدقة يبني ثقة فورية. تسمح لك نقطة النهاية /v2/profile/picture بتحديث هذا الأصل برمجياً، مما يتيح استراتيجيات علامة تجارية ديناميكية (على سبيل المثال، "شعارات الأعياد").


🏗️ المتطلبات التقنية وإرشادات الأصول

لضمان ظهور علامتك التجارية بشكل واضح على جميع الأجهزة، التزم بهذه المواصفات الصارمة:

  1. التنسيق: JPEG هو التنسيق الأصلي لواتساب. ملفات PNG مدعومة ولكن سيتم تحويلها، مما يؤدي غالباً إلى زيادة حجم الملف أو تغييرات طفيفة في الألوان.
  2. الأبعاد:
    • الحد الأدنى: 192x192 بكسل.
    • الموصى به: 640x640 بكسل أو أعلى.
    • نسبة العرض إلى الارتفاع: 1:1 (مربع) حصرياً. سيتم قص الصور غير المربعة من المركز أو رفضها.
  3. حجم الملف: حافظ على حجم الرفع أقل من 2 ميجابايت.

🚀 تحذير "المنطقة الآمنة"

يطبق واتساب قناعاً دائرياً على صورتك المربعة في قائمة الدردشة وشريط الإشعارات.

  • الخطر: إذا وضعت نصاً أو شعارات في زوايا صورتك المربعة، فسيتم قصها.
  • الحل: عامل الدائرة المركزية بنسبة 70% كـ "منطقة آمنة". تأكد من أن أيقونة شعارك متمركزة تماماً ولديها مساحة كافية (مساحة سلبية) حولها.

🛡️ سلوك المزامنة

  • سرعة الانتشار: على عكس الرسائل التي تصل فوراً، تنتقل صور الملف الشخصي عبر بنية تحتية مختلفة لـ CDN. قد يستغرق الأمر ما يصل إلى 5 دقائق لتظهر صورتك الجديدة على جميع أجهزة عملائك.
  • إعدادات الخصوصية: يحترم API قواعد الخصوصية العالمية لجهازك. لخطوط الأعمال، اضبط هذا دائماً على "الجميع".

⚠️ اعتبارات هامة

  • إمكانية الوصول للرابط: يجب أن يكون الرابط file[url] الذي تقدمه متاحاً للجمهور. يحتاج محرك Wawp إلى تنزيل الصورة من هذا الرابط قبل إعادة رفعها إلى واتساب.
  • حدود المعدل: تغيير صورتك بشكل متكرر (على سبيل المثال، كل دقيقة) سيؤدي إلى حظر سبام. حدد التحديثات بحد أقصى 5 مرات في اليوم.
  • الحذف مقابل الاستبدال: لست بحاجة إلى حذف الصورة القديمة قبل رفع واحدة جديدة. الرفع الجديد يستبدل الأصل الحالي تلقائياً.

البارامترات

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

محتوى الطلب

يرسل كـ JSON
string

WhatsApp Instance ID

مثال:
string

API Access Token

مثال:
string

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

مثال:
string

اسم الملف

مثال:
string

نوع MIME للصورة (يوصى بـ image/jpeg)

مثال:

أمثلة الكود

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

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

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

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

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

Example

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

Command Palette

Search for a command to run...