التقاط صورة شاشة المحرك (Screenshot)

إرجاع لقطة شاشة مشفرة بصيغة Base64 للحالة الحالية لمحرك واتساب.

GET
https://api.wawp.net/v2/auth/screenshot?access_token=YOUR_ACCESS_TOKEN&instance_id=Your_Instance_ID&session_name=default

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

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

تسجيل الدخول
اختبار /v2/auth/screenshot
GETPOST

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

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

توصيات

  • استخدم هذه الواجهة فقط لتشخيص محاولات الربط الفاشلة.

  • تحقق من ظهور نوافذ تأكيد تسجيل الخروج أو التحقق بخطوتين (2FA) في لقطة الشاشة.

  • لا تستعلم من هذه الواجهة بشكل مستمر في بيئة الإنتاج.

التشخيص البصري: اكتشاف الأخطاء عبر لقطة الشاشة

تعد نقطة النهاية /v2/auth/screenshot أداة الفحص البصري لمنصة Wawp. نظراً لأن المحركات تعمل في بيئات سحابية معزولة (Headless)، توفر هذه الواجهة لقطة فورية عالية الدقة لما يعرضه متصفح المحرك في اللحظة الحالية.


🏗️ المواصفات التقنية

تعود الاستجابة بصيغة JSON تحتوي على:

  • mimetype: ثابت كـ image/png.
  • data: نص مشفر بصيغة Base64 يمثل الصورة الحالية لشاشة المحرك.

🛡️ حالات الاستخدام الاستراتيجية

  1. اكتشاف النوافذ المنبثقة: مثل نافذة تأكيد تسجيل الخروج أو شاشة إدخال رمز التحقق بخطوتين (2FA).
  2. التحقق من ظهور رمز QR: التأكد من جاهزية رمز الاستجابة السريعة على شاشة المحرك عند تشخيص مشاكل الربط.

البارامترات

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

معاملات الاستعلام والطلب (Query & Body Parameters)

تدعم التمرير عبر الرابط (Query String) أو كـ JSON Body
string

معرف الجلسة المكون من 12 خانة.

مثال:
string

رمز الوصول الخاص بواجهة البرمجة (Access Token).

مثال:
string—

اسم الجلسة الاختياري (كبديل لـ instance_id).

مثال:

برمج بالذكاء الاصطناعي باستخدام Wawp MCP

MCP READY

قم بربط الـ API مباشرة مع Cursor أو Windsurf أو Claude Desktop، ودع الذكاء الاصطناعي يكتب لك كود الربط وينفذه تلقائياً!

طريقة الربط والإعداد

أمثلة الكود

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

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

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

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

Success - Screenshot Data
النوع:
application/json
string *
string *

Example

{
"mimetype": "image/png",
"data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII="
}
طلب غير صالح - معاملات مطلوبة مفقودة
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي
الموضوع السابقالحصول على صورة كود QR
الموضوع التاليإرسال رمز التحقق (OTP)

Command Palette

Search for a command to run...