GET/api/v2/templates/platform

قوالب رقم المنصة الافتراضي

يُرجع فقط القوالب المرتبطة برقم واتساب الرسمي الافتراضي للمنصة. GET /api/v2/templates بدون مرسل ما زال يُرجع كل القوالب.

متى تستخدمه. عندما تريد قوالب رقم المنصة فقط دون خلطها بأرقام الحساب.

مثال الطلب

مثال صحيح: قوالب رقم المنصة المعتمدة

curl --location 'https://raselsms.com/api/v2/templates/platform' \--header 'X-API-Key: YOUR_API_KEY'

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

200 — قوالب رقم المنصة المعتمدة

{  "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"    }  ]}

401 — مفتاح API مفقود أو غير صالح.

{  "success": false,  "requestId": "msgreq_1739012345678_abc123",  "code": "UNAUTHORIZED",  "error": "Missing or invalid API key"}

403 — الهاتف غير موثّق أو الصلاحية غير كافية (غالباً messages:create أو api_keys:read).

{  "success": false,  "requestId": "msgreq_1739012345678_abc123",  "code": "FORBIDDEN",  "error": "Phone not verified or missing permission"}

429 — تم تجاوز حد الطلبات. انتظر Retry-After إن وُجد.

{  "success": false,  "requestId": "msgreq_1739012345678_abc123",  "code": "RATE_LIMITED",  "error": "Rate limit exceeded",  "retryAfterSeconds": 30}

طلب HTTP

GET /api/v2/templates/platform

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

الترويسة	النوع	الوصف
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.

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

الحقل	النوع	الوصف	مثال
data	json	البيانات الأساسية في مسارات القوائم وملخص الحساب.

رموز الحالة

الحالة	الوصف
200	نجاح.
401	مفتاح API مفقود أو غير صالح.
404	المورد غير موجود لمالك مفتاح API.
429	تم تجاوز حد المعدل، أو وصل عدد محاولات التحقق إلى الحد الأقصى.
403	الهاتف غير موثّق، أو الصلاحية ناقصة، أو الحساب لا يستطيع تنفيذ هذا الإجراء.

جرّب الطلب

مفتاح الـ API