GET/api/v2/templates

قائمة القوالب

بدون officialSenderId يُرجع كل القوالب الظاهرة للحساب. كل صف يتضمن officialSender وisPlatformNumber وheaderType وheaderAssetId وheaderPreviewUrl وallowsHeaderMediaOverride. الفلتر الافتراضي للحالة: active وapproved.

مثال الاستجابة

كل القوالب الظاهرة

{
  "data": [
    {
      "id": "6800tpl123def4567890aaaa",
      "name": "order_ready_notice",
      "category": "whatsapp",
      "subType": "utility",
      "language": "ar",
      "status": "approved",
      "headerType": "image",
      "headerValue": null,
      "headerAssetId": null,
      "headerPreviewUrl": null,
      "allowsHeaderMediaOverride": true,
      "provider": "meta",
      "officialSenderId": "platform",
      "officialSender": {
        "id": "platform",
        "scope": "platform",
        "isPlatform": true,
        "isDefault": true,
        "label": null,
        "phoneNumber": null,
        "displayName": "platform"
      },
      "isPlatformNumber": true,
      "isDefault": false,
      "createdAt": "2026-09-01T10:00:00.000Z"
    },
    {
      "id": "6800tpl123def4567890bbbb",
      "name": "promo_offer",
      "category": "whatsapp",
      "subType": "utility",
      "language": "ar",
      "status": "approved",
      "headerType": "image",
      "headerValue": null,
      "headerAssetId": null,
      "headerPreviewUrl": null,
      "allowsHeaderMediaOverride": true,
      "provider": "meta",
      "officialSenderId": "6800abc123def4567890abcd",
      "officialSender": {
        "id": "6800abc123def4567890abcd",
        "scope": "official_sender",
        "isPlatform": false,
        "isDefault": false,
        "label": "SAWA",
        "phoneNumber": "+963911111111",
        "displayName": "SAWA · +963911111111"
      },
      "isPlatformNumber": false,
      "isDefault": false,
      "createdAt": "2026-09-01T10:00:00.000Z"
    }
  ]
}

طلب HTTP

GET /api/v2/templates

ترويسات الطلب

الترويسة	النوع	الوصف
X-API-Key	string	مفتاح Rasel API. أرسله في كل طلب موثّق ما عدا الويب هوك الوارد. *

معاملات الاستعلام

الحقل	النوع	الوصف
category	whatsapp \| sms \| message \| email	فئة القالب: whatsapp أو sms أو message أو email.
status	pending \| approved \| rejected \| active \| disabled	حالة التسليم أو السجل. في الإرسال: sent أو queued أو scheduled. في الموارد الأخرى هي فلتر الحالة أو قيمتها.
provider	user_session \| meta \| internal	فلتر أو قيمة مزوّد القالب: user_session أو meta أو internal.
officialSenderId	string	معرّف مرسل واتساب الرسمي من /api/v2/official-senders. مرادف sender.officialId. استخدم platform لرقم ميتا الافتراضي عند قائمة القوالب.

حقول الاستجابة

الحقل	النوع	الوصف	مثال
data	object[]	الحمولة الأساسية لمسارات القائمة واللقطة.

رموز الحالة

الحالة	الوصف
200	نجاح.
401	مفتاح API مفقود أو غير صالح.
404	المورد غير موجود لمالك مفتاح API.
429	تم تجاوز حد المعدل، أو وصل عدد محاولات التحقق إلى الحد الأقصى.

جرّب الطلب

مفتاح الـ API