أمثلة كاملة لهياكل JSON المستخدمة في الطلبات والاستجابات

أمثلة كاملة لهياكل JSON المستخدمة في الطلبات والاستجابات مع WhatsApp API من Whats360

عند استخدام WhatsApp API من خلال منصة Whats360، يُعد فهم هياكل JSON المستخدمة في الطلبات والاستجابات أمراً ضرورياً لتنفيذ العمليات بشكل صحيح. في هذا المقال، سنقدم أمثلة كاملة لهياكل JSON المستخدمة في الطلبات والاستجابات، مع شرح تفصيلي لكل منها.

1. إرسال رسالة نصية

هيكل JSON للطلب

لإرسال رسالة نصية، يمكنك استخدام الهيكل التالي:



{
    "client_id": "CLIENT_ID",
    "mobile": "919999999999",
    "text": "مرحباً، هذا رسالة تجريبية من Whats360 API!",
    "token": "YOUR_API_KEYS"
}

هيكل JSON للاستجابة الناجحة

عند نجاح إرسال الرسالة، ستتلقى الاستجابة التالية:



{
    "success": true,
    "message": "The message has been successfully sent.",
    "data": {}
}

2. إرسال وسائط (صورة أو فيديو)

هيكل JSON للطلب

لإرسال وسائط مثل صورة أو فيديو، يمكنك استخدام الهيكل التالي:



{
    "client_id": "CLIENT_ID",
    "mobile": "919999999999",
    "media_url": "https://example.com/image.jpg",
    "caption": "هذه صورة تجريبية",
    "token": "YOUR_API_KEYS"
}

هيكل JSON للاستجابة الناجحة

عند نجاح إرسال الوسائط، ستتلقى الاستجابة التالية:



{
    "success": true,
    "message": "The media has been successfully sent.",
    "data": {}
}

3. إرسال رسالة باستخدام قالب (Template)

هيكل JSON للطلب

لإرسال رسالة باستخدام قالب معتمد من WhatsApp، يمكنك استخدام الهيكل التالي:



{
    "client_id": "CLIENT_ID",
    "mobile": "919999999999",
    "template_id": 1,
    "parameters": {
        "name": "أحمد",
        "date": "2023-10-01"
    },
    "token": "YOUR_API_KEYS"
}

هيكل JSON للاستجابة الناجحة

عند نجاح إرسال الرسالة باستخدام القالب، ستتلقى الاستجابة التالية:



{
    "success": true,
    "message": "The template message has been successfully sent.",
    "data": {}
}

4. تتبع حالة الرسالة

هيكل JSON للطلب

لتتبع حالة رسالة معينة، يمكنك استخدام الهيكل التالي:



{
    "client_id": "CLIENT_ID",
    "message_id": "msg_12345",
    "token": "YOUR_API_KEYS"
}

هيكل JSON للاستجابة الناجحة

عند نجاح تتبع حالة الرسالة، ستتلقى الاستجابة التالية:



{
    "success": true,
    "message": "The message status has been retrieved.",
    "data": {
        "status": "delivered",
        "timestamp": "2023-10-01T12:00:00Z"
    }
}

5. إدارة جهات الاتصال

هيكل JSON للطلب

لإضافة جهة اتصال جديدة، يمكنك استخدام الهيكل التالي:



{
    "client_id": "CLIENT_ID",
    "name": "أحمد",
    "mobile": "919999999999",
    "token": "YOUR_API_KEYS"
}

هيكل JSON للاستجابة الناجحة

عند نجاح إضافة جهة الاتصال، ستتلقى الاستجابة التالية:



{
    "success": true,
    "message": "The contact has been successfully added.",
    "data": {
        "contact_id": "contact_12345"
    }
}

الخلاصة

فهم هياكل JSON المستخدمة في الطلبات والاستجابات مع WhatsApp API من Whats360 يُعد أمراً ضرورياً لتنفيذ العمليات بشكل صحيح. من خلال الأمثلة المذكورة في هذا المقال، يمكنك البدء في استخدام API بثقة وفعالية.

ابدأ بتجربة هذه الهياكل اليوم، واستمتع بتجربة تطوير سلسة مع Whats360 API.

الكلمات المفتاحية: هياكل JSON, WhatsApp API, Whats360 API, إرسال رسائل, إرسال وسائط, قوالب الرسائل, تتبع الحالة, إدارة جهات الاتصال, واتس 360, روبوت دردشة, إدارة الحملات, تطوير التطبيقات, واجهة برمجة التطبيقات.