GET/api/v2/whatsapp-web/sessions
جلسات واتساب ويب
الجلسات المرتبطة بحسابك. استخدم accountId (اسم الجلسة) في الإرسال وفي قائمة المحادثات. تُستبعد جلسات النظام وفحص الحضور. لا QR ولا أسرار.
متى تستخدمه. للحصول على accountId قبل سحب المحادثات أو الإرسال.
مثال الطلب
مثال صحيح: قائمة الجلسات
curl --location 'https://raselsms.com/api/v2/whatsapp-web/sessions' \--header 'X-API-Key: YOUR_API_KEY'مثال الاستجابة
200 — قائمة الجلسات
{ "success": true, "data": { "sessions": [ { "accountId": "session-user-whatsapp-1", "displayName": "Sales WhatsApp", "status": "active", "connectionState": "ready", "moduleType": "whatsapp_web" } ] }}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/whatsapp-web/sessions
ترويسات الطلب
| الترويسة | النوع | الوصف |
|---|---|---|
| X-API-Key | string | مفتاح Rasel API. أرسله في كل طلب موثّق ما عدا الويب هوك الوارد. * |
حقول الاستجابة
| الحقل | النوع | الوصف | مثال |
|---|---|---|---|
| success | boolean | صحيح عندما ينجح الإجراء، أو عندما ينجح مستلم واحد على الأقل في الدفعة. | |
| data | json | البيانات الأساسية في مسارات القوائم وملخص الحساب. |
رموز الحالة
| الحالة | الوصف |
|---|---|
| 200 | نجاح. |
| 401 | مفتاح API مفقود أو غير صالح. |
| 403 | الهاتف غير موثّق، أو الصلاحية ناقصة، أو الحساب لا يستطيع تنفيذ هذا الإجراء. |
| 429 | تم تجاوز حد المعدل، أو وصل عدد محاولات التحقق إلى الحد الأقصى. |
جرّب الطلب
الطلب
GET /api/v2/whatsapp-web/sessionsالاستجابة
نفّذ طلباً لعرض الاستجابة.