دریافت وضعیت یک یا چند پیام
آدرس فراخوانی :
[document_shortcode type=”POST” url=”http://panel.signalads.com/rest/api/v1/message/status.json”]
پارامترهای ورودی :
| # | فیلد | نام | validations |
| 1 | ids[] | شناسه پیام‌ها | آرایه ای از شناسه پیامهای کاربر |
برای مثال ۲ حالت ارسال در زیر بیان شده است:
json :
{
"ids":[12345,12346]
}form-data :
ids[0] = 12345
ids[1] = 12346پاسخ:
json :
{
"success": true,
"data": [
{
"id": 12345,
"message": "متن پیام ارسالی",
"status": "2",
"cost": 4,
"time": 1538896812,
"from": "+98simcard",
"receipts": [
{
"number": "+989...",
"time": 1538896812,
"status": "3"
},
{
"number": "+989...",
"time": 1538896812,
"status": "5"
}
]
},
{
"id": 12346,
"message": "متن پیام ارسالی",
"status": "2",
"cost": 4,
"time": 1538896812,
"from": "+9850004344",
"receipts": [
{
"number": "+989...",
"time": 1538896812,
"status": "3"
}
]
}
]
}success
در صورتی که مقدار آن true باشد پاسخ درخواست شما موفقیت آمیز بوده است.
data
حاوی اطلاعات پیامهای ارسالی است
| # | فیلد | نام |
| 1 | ids | شناسه پیام‌ها |
| ۲ | message | متن پیام |
| ۳ | status | وضعیت پیام |
| ۴ | time | زمان ثبت |
| ۵ | from | شماره فرستنده |
| ۶ | receipts | لیست گیرندگان |
status
| # | فیلد | نام |
| 1 | ۱ | منتظر تایید |
| ۲ | ۲ | تایید شده |
| ۳ | ۳ | رد شده |
| ۴ | ۴ | در حال ارسال |
| ۵ | ۵ | بروز خطا |
receipts
| # | فیلد | نام |
| 1 | number | گیرنده |
| ۲ | time | آخرین زمان بروزرسانی وضعیت |
| ۳ | status | وضعیت پیام ها |
وضعیت پیام ها
| # | فیلد | نام |
| 1 | ۱ | آماده ارسال وضعیت پیام ها |
| ۲ | ۲ | در حال ارسال |
| ۳ | ۳ | ارسال شده به مخابرات |
| ۴ | ۴ | نرسیده به مخابرات |
| ۵ | ۵ | رسیده به مخابرات |
| ۶ | ۶ | رسیده به گوشی |
| ۷ | ۷ | نرسیده به گوشی |
| ۸ | ۸ | برگشتی |
| ۹ | ۹ | خطای مخابراتی |