الحصول على معرف حالة جديد

أنشئ معرف رسالة جديداً لتحديث الحالة. مفيد لتجنب التكرار وضمان تطابق البيانات.

GET
https://api.wawp.net/v2/status/new-message-id?access_token=123456789&instance_id=123456789

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

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

تسجيل الدخول
اختبار /v2/status/new-message-id
GET
GET

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

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

توصيات

  • Generate a new ID for every single status post.

  • Do not reuse IDs; it will cause sync errors.

أداة المعماري: توليد المعرفات مسبقاً

تعد نقطة النهاية /v2/status/new-message-id أداة للمطورين المتقدمين الذين يبنون أنظمة عالية الموثوقية. فهي تتيح لك حجز معرف رسالة واتساب صالح قبل إرسال المحتوى فعلياً.


🏗️ المشكلة: "الاستجابة المفقودة"

في تدفق الواجهة التقليدي:

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

🛡️ الحل: ضمان العمليات (Idempotency)

من خلال توليد المعرف أولاً، يمكنك التحكم في سير العمل:

  1. التوليد والحفظ: استدعِ GET /v2/status/new-message-id واحفظ المعرف في قاعدة بياناتك بحالة "قيد الرفع".
  2. الرفع: قم برفع الحالة، وإذا فشل الاتصال، يمكنك دائماً الرجوع لقاعدة بياناتك لمعرفة ما إذا كان هذا المعرف قد استخدم بنجاح.

حالة استخدام: تتبع المشاهدين

إذا كنت تريد تتبع من شاهد حالة معينة:

  1. تحتاج إلى المعرف فوراً لإعداد مستمع الويب هوك الخاص بك.
  2. من خلال توليده أولاً، يمكنك تجهيز نظام التحليلات الخاص بك ليبدأ الاستماع حتى قبل إتمام عملية الرفع.

البارامترات

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

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

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

Your unique WhatsApp Instance ID

مثال:
string

Your API Access Token

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/status/new-message-id";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "123456789"
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: طلب غير صالح - معاملات مطلوبة مفقودة");
24 }
25 if (response.status === 400) {
26 console.error("Error 400: طلب غير صالح (تنسيق XML)");
27 }
28 if (response.status === 400) {
29 console.error("Error 400: طلب غير صالح (نص عادي)");
30 }
31 if (response.status === 401) {
32 console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
33 }
34 if (response.status === 401) {
35 console.error("Error 401: غير مصرح (تنسيق XML)");
36 }
37 if (response.status === 404) {
38 console.error("Error 404: غير موجود - الجلسة غير موجودة");
39 }
40 if (response.status === 404) {
41 console.error("Error 404: غير موجود (تنسيق XML)");
42 }
43 if (response.status === 500) {
44 console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
45 }
46 if (response.status === 500) {
47 console.error("Error 500: خطأ في الخادم الداخلي (HTML)");
48 }
49 if (response.status === 502) {
50 console.error("Error 502: بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي");
51 }
52 if (response.status === 502) {
53 console.error("Error 502: بوابة غير صالحة (تنسيق XML)");
54 }
55
56 const errorText = await response.text();
57 console.error(`Error ${response.status}: ${errorText}`);
58 })
59 .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 59, Col 1javascript

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

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

New ID generated
النوع:
السيناريو:
application/json
string *

Example

{
"id": "3EB0BCB2E3D4"
}
طلب غير صالح - معاملات مطلوبة مفقودة
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي
الموضوع السابقحالة فيديو
الموضوع التاليحذف الحالة

Command Palette

Search for a command to run...