حماية الرقم والإحصائيات
إيقاف الرقم مؤقتًا
POST
/v2/numbers/{numberId}/pause- الصلاحية:
numbers:write - Idempotency-Key:اختياري
- بيغيّر إعدادات
من 5 دقايق لـ 7 أيام. الحملات والرسايل للأرقام الجديدة بتستنى؛ الردود على المحادثات الحديثة شغالة.
البارامترات
المسار
| الاسم | النوع | القيود | الوصف |
|---|---|---|---|
numberIdإجباري | النوعstring | القيود— | الوصفرقم الـ id بتاع الرقم (من GET /v2/numbers). |
الهيدرز
| الاسم | النوع | القيود | الوصف |
|---|---|---|---|
Idempotency-Keyاختياري | النوعstring | القيود≤ 191 حرف | الوصفid فريد من عندك للعملية دي (حد أقصى 191 حرف ASCII). لو كررت بنفس المفتاح ونفس الـ body بيرجعلك أول رد ومعاه Idempotent-Replayed: true — عمرها ما تتنفذ مرتين. بيتحفظ 24 ساعة. |
X-Request-Idاختياري | النوعstring | القيود— | الوصفاختياري: id الطلب بتاعك وبيرجعلك (غير كده بنعمل req_…). اديه للدعم لو احتجت. |
الـ Body
| الاسم | النوع | القيود | الوصف |
|---|---|---|---|
minutesإجباري | النوعinteger | القيود5–10080 | الوصفمدة الإيقاف: من 5 دقايق لـ 7 أيام. الحملات والرسايل للأرقام الجديدة بتستنى؛ والرد على اللي كلموك آخر 24 ساعة شغال. |
الطلب
curl -X POST "https://mursilat.com/api/v2/numbers/cm1abcd2345efgh6789ijkl/pause" \
-H "Authorization: Bearer $WASLA_API_KEY" \
-H "Idempotency-Key: order-1042-confirm" \
-H "Content-Type: application/json" \
-d '{
"minutes": 120
}'const res = await fetch('https://mursilat.com/api/v2/numbers/cm1abcd2345efgh6789ijkl/pause', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.WASLA_API_KEY}`,
'Idempotency-Key': 'order-1042-confirm',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"minutes": 120
}),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
console.log(data);import os
import requests
headers = {"Authorization": f"Bearer {os.environ['WASLA_API_KEY']}", "Idempotency-Key": "order-1042-confirm"}
res = requests.post(
"https://mursilat.com/api/v2/numbers/cm1abcd2345efgh6789ijkl/pause",
headers=headers,
json={
"minutes": 120
},
timeout=30,
)
data = res.json()
if not res.ok:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")
print(data)<?php
$ch = curl_init('https://mursilat.com/api/v2/numbers/cm1abcd2345efgh6789ijkl/pause');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('WASLA_API_KEY'),
'Idempotency-Key: order-1042-confirm',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'minutes' => 120
], JSON_UNESCAPED_UNICODE),
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status >= 400) { throw new Exception($data['error']['code'] . ': ' . $data['error']['message']); }
print_r($data);{
"minutes": 120
}الرد
200مثال
{
"numberId": "cm1abcd2345efgh6789ijkl",
"paused": true,
"until": "2026-10-13T10:00:00.000Z",
"reason": "CUSTOMER_PAUSED"
}شكل الرد
حقول الرد في المثال. افتح الكائنات والقوايم.
responseobject4 حقل
- numberIdstring "cm1abcd2345efgh6789ijkl"
- pausedboolean true
- untilstring "2026-10-13T10:00:00.000Z"
- reasonstring "CUSTOMER_PAUSED"
الأخطاء
غير أخطاء المصادقة وحدود الطلبات والتحقق اللي ممكن ترجع من أي endpoint:
- 404NUMBER_NOT_FOUNDالرقم مش موجود في الحساب.
حماية الرقم والسلوك
زي أي إيقاف من الحماية، بيوقف الحملات والرسايل للأرقام الجديدة؛ والرد على اللي كلموك آخر 24 ساعة شغال. تقدر تشيل إيقافك انت بس (NUMBER_PAUSE_NOT_YOURS).
جرّب
ابعت الطلب ده من متصفحك لـ API مرسلات.
مثال موثّقمعاينة — النسخة دي من التوثيق مش على mursilat.com، فالكونسول بيعرض المثال الموثّق بدل ما يكلم الـ API.
الطلبات الحقيقية بتستخدم رقمك وباقتك الحقيقيين: ممكن تبعت رسايل واتساب وتصرف من رصيدك وتمسح بيانات. (بيغيّر إعدادات)
متخزن في ذاكرة التبويب ده بس: عمره ما بيتحفظ ولا بيتحط في الرابط، وبيتبعت لـ mursilat.com بس. لو عملت reload بيتنسي.