الحصول على معرف حالة جديد
أنشئ معرف رسالة جديداً لتحديث الحالة. مفيد لتجنب التكرار وضمان تطابق البيانات.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
Generate a new ID for every single status post.
Do not reuse IDs; it will cause sync errors.
أداة المعماري: توليد المعرفات مسبقاً
تعد نقطة النهاية /v2/status/new-message-id أداة للمطورين المتقدمين الذين يبنون أنظمة عالية الموثوقية. فهي تتيح لك حجز معرف رسالة واتساب صالح قبل إرسال المحتوى فعلياً.
🏗️ المشكلة: "الاستجابة المفقودة"
في تدفق الواجهة التقليدي:
- تقوم باستدعاء
POST /v2/status/image. - يقوم الخادم بمعالجتها وإرسالها إلى واتساب.
- ينقطع اتصال الإنترنت لديك بعد إرسال الطلب ولكن قبل تلقي الاستجابة التي تحتوي على المعرف. النتيجة: تم نشر الحالة، لكن قاعدة بياناتك لا تعرف المعرف. إذا حاولت النشر مرة أخرى، ستحصل على محتوى مكرر.
🛡️ الحل: ضمان العمليات (Idempotency)
من خلال توليد المعرف أولاً، يمكنك التحكم في سير العمل:
- التوليد والحفظ: استدعِ
GET /v2/status/new-message-idواحفظ المعرف في قاعدة بياناتك بحالة "قيد الرفع". - الرفع: قم برفع الحالة، وإذا فشل الاتصال، يمكنك دائماً الرجوع لقاعدة بياناتك لمعرفة ما إذا كان هذا المعرف قد استخدم بنجاح.
حالة استخدام: تتبع المشاهدين
إذا كنت تريد تتبع من شاهد حالة معينة:
- تحتاج إلى المعرف فوراً لإعداد مستمع الويب هوك الخاص بك.
- من خلال توليده أولاً، يمكنك تجهيز نظام التحليلات الخاص بك ليبدأ الاستماع حتى قبل إتمام عملية الرفع.
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
بارامترات الرابط
جزء من مسار الرابط أو استعلامstring | Your unique WhatsApp Instance ID مثال: | ||
string | Your API Access Token مثال: |
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"id": "3EB0BCB2E3D4"
}Command Palette
Search for a command to run...