رابط الوصول المؤقت

إنشاء أو استرجاع أو إلغاء رابط وصول مؤقت لنسخة الواتساب. الرابط يفتح صفحة QR-code لربط النسخة دون مشاركة بيانات الدخول.

GET
https://api.wawp.net/v2/session/temp-link?access_token=YOUR_ACCESS_TOKEN&instance_id=Your_Instance_ID

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

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

تسجيل الدخول
اختبار /v2/session/temp-link
GETPOSTDELETE

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

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

توصيات

  • ولد الرابط مباشرة قبل أن يكون المستخدم جاهزاً لمسح QR code.

  • استدعِ DELETE بعد اتصال ناجح لمنع إعادة استخدام الرابط.

رابط الوصول المؤقت: /v2/session/temp-link

تدير نقطة النهاية روابط QR-code قصيرة المدة للنسخة. الرابط المولد يوجه إلى https://app.wawp.net/temp-qr/{token} وصالح لـ 30 دقيقة.

حالات الاستخدام

  • سيناريوهات الدعم: السماح لموظف دعم بمسح QR code وربط رقم العميل دون مشاركة بيانات الدخول الرئيسية.
  • التفعيل عن بُعد: إرسال الرابط لعضو الفريق لإنهاء ربط الواتساب على جهازه الخاص.
  • إعادة الاتصال السريعة: إنشاء رابط جديد بعد تسجيل خروج أو إعادة تشغيل الجلسة.

نقاط النهاية

GET /v2/session/temp-link

ترجع الرابط النشط حالياً، إن وجد. ترجع { link: null } إذا لا يوجد رابط نشط.

POST /v2/session/temp-link

تلغي أي رابط نشط موجود وتولد رابطاً جديداً. ترجع الرابط الجديد ووقت انتهاء صلاحيته.

DELETE /v2/session/temp-link

تلغي فوراً جميع روابط الوصول المؤقتة للنسخة.

ملاحظات الأمان

  • الروابط تُلغى عملياً عند توليد رابط جديد.
  • التوكن عشوائي وطوله 64 حرفاً.
  • قم بإلغاء الروابط عندما لا تكون هناك حاجة لها.

البارامترات

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

بارامترات الرابط

جزء من مسار الرابط أو استعلام
string

معرف النسخة الفريد

مثال:
string

مفتاح الوصول الخاص بـ API

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/session/temp-link";
3const params = new URLSearchParams({
4 "instance_id": "Your_Instance_ID",
5 "access_token": "YOUR_ACCESS_TOKEN"
6}).toString();
7
8
9fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
10 method: "GET",
11 headers: { "Content-Type": "application/json" },
12
13})
14 .then(async (response) => {
15 if (response.ok) {
16 const data = await response.json();
17 console.log("Success:", data);
18 return data;
19 }
20
21 // Error Handling
22 if (response.status === 400) {
23 console.error("Error 400: Bad Request - Missing access_token or instance_id");
24 }
25 if (response.status === 401) {
26 console.error("Error 401: Unauthorized - Invalid access token or instance ID");
27 }
28
29 const errorText = await response.text();
30 console.error(`Error ${response.status}: ${errorText}`);
31 })
32 .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 32, Col 1javascript

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

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

Success - Link retrieved or generated
application/json
string *
string *
string *
string *

Example

{
"status": "success",
"link": "https://app.wawp.net/temp-qr/a1b2c3d4e5f6...",
"expires_at": "2026-06-19T19:25:00.000Z",
"message": "Temporary access link generated successfully"
}
Bad Request - Missing access_token or instance_id
Unauthorized - Invalid access token or instance ID
الموضوع السابقحدود معدل إرسال الجلسة
الموضوع التاليتسجيل الخروج من الجلسة

Command Palette

Search for a command to run...