لیست سیاه خط

حذف از لیست سیاه

مسدودی شماره‌ها روی یک خط را برمی‌دارد. پارامترها در query string فرستاده می‌شوند.

DELETE
https://api.payamras.ir/v1/YOUR_API_KEY/line/blocked/remove.json
  • حداکثر ۵۰ شماره در هر درخواست.
  • فقط شماره‌هایی که از پنل یا وب‌سرویس مسدود شده‌اند قابل حذف‌اند؛ مسدودی اپراتور یا سیستم را نمی‌توان برداشت.

پارامترها

نامنوعتوضیح
linenumber الزامی String شماره خط.
receptor الزامی String شماره‌ها، جداشده با ویرگول.

نمونه درخواست

curl -X DELETE -G "https://api.payamras.ir/v1/YOUR_API_KEY/line/blocked/remove.json" \
  --data-urlencode "linenumber=10004346" \
  --data-urlencode "receptor=09121234567"

پاسخ

فیلدهای هر ردیف entries:

فیلدنوعتوضیح
message String نتیجه عملیات.
response.json
{
    "return": {
        "status": 200,
        "message": "تایید شد"
    },
    "entries": {
        "message": "شماره‌ها از لیست سیاه حذف شدند"
    }
}

خطاهای رایج

علاوه بر خطاهای عمومی مثل 403 و 418، این متد ممکن است این کدها را در return.status برگرداند:

  • 412 فرستنده نامعتبر است، یا تعداد آیتم‌ها از سقف مجاز بیشتر است.