مقدمه
این مستندات راهنمای کامل وبسرویس پیامک سامانه پیامک (نسخه ۳ – REST) است. درخواستها از طریق POST (با بدنه JSON) انجام میشوند و پاسخها به صورت JSON بازگردانده میشوند.
https://api-payamak.com/api/v3/rest/
برای احراز هویت از هدرهای Authorization یا Token استفاده کنید. تمام متدها با متد POST فراخوانی میشوند.
احراز هویت
برای احراز هویت، API-KEY خود را از طریق هدرهای زیر ارسال کنید:
Authorization: YOUR_API_KEYToken: YOUR_API_KEYBearer پیشوند:Authorization: Bearer YOUR_API_KEYUsername: YOUR_USERNAMEPassword: YOUR_PASSWORDسرویس پیامک
ارسال پیامک POST
https://api-payamak.com/api/v3/rest/sms/send
ارسال پیامک به یک یا چند گیرنده (حداکثر ۲۰۰ گیرنده در هر فراخوانی).
پارامترهای ورودی (بدنه JSON)
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| from | String | اجباری | شماره فرستنده |
| recipients | Array of String | اجباری | لیست گیرندگان |
| message | String | اجباری | متن پیام (حداکثر ۹۰۰ کاراکتر) |
| type | Integer | اختیاری | نوع پیام (۰=معمولی، ۱=فلش) – پیشفرض ۰ |
POST https://api-payamak.com/api/v3/rest/sms/send
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"from": "21xxxxxxxx",
"recipients": ["09123456789", "09123456789"],
"message": "خدمات پیام کوتاه",
"type": 0
}
{
"return": {
"status": 200,
"message": "پیام با موفقیت در صف ارسال قرار گرفت"
},
"data": {
"messageid": 8792343,
"message": "خدمات پیام کوتاه",
"state": "فعال",
"from": "21xxxxxxxx",
"date": 1786619709
}
}
414 بازگردانده میشود.
ارسال گروهی (چند پیام) POST
https://api-payamak.com/api/v3/rest/sms/multiple-send
ارسال چندین پیام متفاوت به گیرندههای مختلف با شمارههای فرستنده متفاوت. تعداد آرایهها باید برابر باشد.
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| fromArray | Array of String | اجباری | شمارههای فرستنده |
| recipients | Array of String | اجباری | شمارههای گیرنده |
| messageArray | Array of String | اجباری | متن پیامها |
| typeArray | Array of Integer | اجباری | نوع هر پیام (۰ یا ۱) |
419 بازگردانده میشود.
POST https://api-payamak.com/api/v3/rest/sms/multiple-send
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"fromArray": ["21xxxx", "21xxxx"],
"recipients": ["09123456789", "09123456789"],
"messageArray": ["پیام", "پیام"],
"typeArray": [0, 0]
}
{
"return": {
"status": 200,
"message": "پیامهای گروهی با موفقیت در صف ارسال قرار گرفتند"
},
"entries": [
{
"index": 0,
"messageid": 8792343,
"message": "پیام",
"state": "فعال",
"from": "21xxxx",
"to": "09123456789",
"date": 1786619709
},
{
"index": 1,
"messageid": 8792344,
"message": "پیام",
"state": "فعال",
"from": "21xxxx",
"to": "09123456789",
"date": 1786619709
}
]
}
ارسال پیامک با الگو (Pattern) POST
https://api-payamak.com/api/v3/rest/sms/pattern-send
ارسال پیامک با استفاده از الگوهای از پیش تعریفشده در پنل کاربری. با ارسال شناسه الگو و پارامترهای مورد نظر، پیامک بهصورت خودکار با متن نهایی ارسال میشود.
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| from | String | اجباری | شماره فرستنده (خط اختصاصی) |
| recipients | Array of String | اجباری | لیست شماره گیرندگان |
| message | JSON String | اجباری | پارامترهای الگو بهصورت JSON |
| pattern_id | Integer | اجباری | شناسه الگو در پنل کاربری |
| type | Integer | اختیاری | ۰=معمولی، ۱=فلش (پیشفرض: ۰) |
message باید بهصورت JSON string ارسال شود. کلیدهای موجود در آن باید با پارامترهای تعریفشده در الگو (پنل) مطابقت داشته باشند.
POST https://api-payamak.com/api/v3/rest/sms/pattern-send
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"from": "1000xxxx",
"recipients": ["09123456789"],
"message": {"name":"محمدرضا"},
"pattern_id": 100,
"type": 0
}
{
"return": {
"status": 200,
"message": "پیام با موفقیت در صف ارسال قرار گرفت"
},
"data": {
"messageid": 222910475,
"message": "مشترک گرامی، محمدرضا عزیز خوش آمدید.",
"state": "فعال",
"from": "+981000xxxx",
"date": "1787466576"
}
}
{
"status": 404,
"message": "الگوی مورد نظر یافت نشد"
}
کنترل وضعیت پیامک POST
https://api-payamak.com/api/v3/rest/sms/status
دریافت وضعیت پیامهای ارسال شده (حداکثر ۵۰ شناسه در هر فراخوانی).
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| messageid | Array of Long | اجباری | شناسههای پیام |
POST https://api-payamak.com/api/v3/rest/sms/status
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"messageid": [8792343, 8792344]
}
{
"return": {
"status": 200,
"message": "وضعیت پیامها"
},
"entries": [
{
"messageid": 8792343,
"from": "21xxxx",
"number": "09123456789",
"state": 10,
"status": "رسیده به گیرنده"
},
{
"messageid": 8792344,
"from": "21xxxx",
"number": "09123456789",
"state": 4,
"status": "ارسال به مخابرات"
}
]
}
جزئیات پیامک POST
https://api-payamak.com/api/v3/rest/sms/select
مشابه Status اما با اطلاعات کاملتر (متن پیام، شماره فرستنده، تاریخ).
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| messageid | Array of Long | اجباری | شناسههای پیام |
POST https://api-payamak.com/api/v3/rest/sms/select
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"messageid": [8792343]
}
{
"return": {
"status": 200,
"message": "جزئیات پیام"
},
"entries": [
{
"messageid": 8792343,
"message": "خدمات پیام کوتاه",
"number": "09123456789",
"state": 10,
"status": "رسیده به گیرنده",
"from": "21xxxx",
"date": 1786619709
}
]
}
لیست ارسالها POST
https://api-payamak.com/api/v3/rest/sms/selectoutbox
دریافت لیست پیامهای ارسال شده در بازه زمانی (حداکثر ۱ روز).
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| startdate | UnixTime | اجباری | تاریخ شروع |
| enddate | UnixTime | اجباری | تاریخ پایان |
POST https://api-payamak.com/api/v3/rest/sms/selectoutbox
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"startdate": 1759533200,
"enddate": 1809619600
}
{
"return": {
"status": 200,
"message": "لیست ارسالها"
},
"entries": [
{
"messageid": 8792343,
"message": "test",
"number": "09123456789",
"from": "21xxxx",
"state": 10,
"status": "رسیده به گیرنده",
"date": 1786619709
}
]
}
آخرین وضعیت پیام POST
https://api-payamak.com/api/v3/rest/sms/latest
دریافت آخرین پیام ارسالشده (آخرین رکورد بر اساس شناسه) همراه با جزئیات کامل.
این متد نیازی به پارامتر ورودی ندارد.
POST https://api-payamak.com/api/v3/rest/sms/latest
Headers: Authorization: YOUR_API_KEY
{
"return": {
"status": 200,
"message": "آخرین وضعیت پیام"
},
"data": {
"messageid": 8792340,
"message": "خدمات پیام کوتاه",
"recipients_count": 2,
"recipients": ["09123456789", "09123456789"],
"from": "21xxxxxxxx",
"state": 10,
"date": 1786619709
}
}
آخرین ارسالها POST
https://api-payamak.com/api/v3/rest/sms/latestoutbox
دریافت آخرین پیامهای ارسال شده (حداکثر ۲۰۰ مورد).
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| pagesize | Integer | اختیاری | تعداد نتایج (پیشفرض ۲۰۰) |
POST https://api-payamak.com/api/v3/rest/sms/latestoutbox
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"pagesize": 50
}
{
"return": {
"status": 200,
"message": "تایید شد"
},
"entries": [
{
"messageid": 8792343,
"from": "21xxxx",
"to": "09123456789",
"message": "test",
"state": 10,
"status": "رسیده به گیرنده",
"date": 1786619709
}
]
}
تعداد ارسالها POST
https://api-payamak.com/api/v3/rest/sms/countoutbox
تعداد، پارتیشنها و هزینه کل ارسالها در بازه زمانی.
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| startdate | UnixTime | اجباری | تاریخ شروع |
| enddate | UnixTime | اجباری | تاریخ پایان |
POST https://api-payamak.com/api/v3/rest/sms/countoutbox
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"startdate": 1759533200,
"enddate": 1789619600
}
{
"return": {
"status": 200,
"message": "تایید شد"
},
"data": {
"startdate": 1759533200,
"enddate": 1789619600,
"sumpart": 10,
"sumcount": 10,
"cost": 50
}
}
تعداد دریافتها POST
https://api-payamak.com/api/v3/rest/sms/countinbox
تعداد پیامهای دریافت شده با فیلتر شماره و وضعیت خواندهشدن.
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| startdate | UnixTime | اجباری | تاریخ شروع |
| enddate | UnixTime | اجباری | تاریخ پایان |
| number | String | اختیاری | شماره خط گیرنده |
| isread | Integer | اختیاری | ۰=نخوانده، ۱=خوانده |
POST https://api-payamak.com/api/v3/rest/sms/countinbox
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"startdate": 1759533200,
"enddate": 1789619600,
"number": "1000xxxx",
"isread": 0
}
{
"return": {
"status": 200,
"message": "تایید شد"
},
"data": {
"startdate": 1759533200,
"enddate": 1789619600,
"isread": 0,
"count": 5
}
}
دریافت پیامهای دریافتی POST
https://api-payamak.com/api/v3/rest/sms/inbox
دریافت لیست پیامهای دریافتی کاربر با قابلیت تعیین تعداد و offset (صفحهبندی ساده).
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| count | Integer | اختیاری | تعداد پیامهای مورد نظر (پیشفرض ۵۰) |
| offset | Integer | اختیاری | میزان offset (پیشفرض ۰) |
POST https://api-payamak.com/api/v3/rest/sms/inbox
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"count": 50,
"offset": 0
}
{
"return": {
"status": 200,
"message": "لیست پیامهای دریافتی"
},
"entries": [
{
"messageid": 35850015,
"message": "خدمات پیام کوتاه",
"to": "1000xxxx",
"from": "09123456789",
"date": 1789619600
}
]
}
دریافت پیامک (صفحهبندی) POST
https://api-payamak.com/api/v3/rest/sms/inboxpaged
دریافت پیامهای دریافتی با صفحهبندی (تا ۵۰۰ مورد در هر صفحه).
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| number | String | اختیاری | شماره خط |
| isread | Integer | اختیاری | ۰=نخوانده، ۱=خوانده |
| page | Integer | اختیاری | شماره صفحه (پیشفرض ۱) |
| pagesize | Integer | اختیاری | تعداد در هر صفحه (پیشفرض ۲۰۰، حداکثر ۵۰۰) |
POST https://api-payamak.com/api/v3/rest/sms/inboxpaged
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"number": "1000xxxx",
"isread": 0,
"page": 1,
"pagesize": 200
}
{
"return": {
"status": 200,
"message": "تایید شد"
},
"entries": [
{
"messageid": 35850015,
"message": "خدمات پیام کوتاه",
"from": "09123456789",
"to": "1000xxxx",
"date": 1357206241
}
],
"current": {
"totalcount": "1",
"currentpage": "1",
"totalpages": "1",
"pagesize": "200"
}
}
دریافت پیامک POST
https://api-payamak.com/api/v3/rest/sms/receive
دریافت حداکثر ۵۰ پیام خواندهنشده و بروزرسانی خودکار وضعیت به خواندهشده.
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| number | String | اختیاری | شماره خط |
| isread | Integer | اختیاری | ۰=نخوانده (پیشفرض)، ۱=خوانده |
POST https://api-payamak.com/api/v3/rest/sms/receive
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"number": "1000xxxx",
"isread": 0
}
{
"return": {
"status": 200,
"message": "تایید شد"
},
"entries": [
{
"messageid": 35850015,
"message": "خدمات پیام کوتاه",
"from": "09123456789",
"to": "1000xxxx",
"date": 1787206241
}
]
}
کنترل وضعیت با شماره POST
https://api-payamak.com/api/v3/rest/sms/statusbynumber
دریافت وضعیت پیامهای ارسال شده به یک شماره خاص از تاریخ شروع تا حال.
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| number | String | اجباری | شماره موبایل گیرنده |
| startdate | UnixTime | اجباری | تاریخ شروع |
| pagesize | Integer | اختیاری | تعداد نتایج (پیشفرض 50، حداکثر 50) |
POST https://api-payamak.com/api/v3/rest/sms/statusbynumber
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"number": "09123456789",
"startdate": 1785677000,
"pagesize": 50
}
{
"return": {
"status": 200,
"message": "تایید شد"
},
"entries": [
{
"messageid": 8792343,
"message": "خدمات پیام کوتاه",
"to": "09123456789",
"status": 10,
"statustext": "رسیده به گیرنده",
"date": 1785677000
}
]
}
سرویس کاربر
اعتبار کاربر POST
https://api-payamak.com/api/v3/rest/my/credit
دریافت اعتبار باقیمانده حساب کاربری (ریال).
POST https://api-payamak.com/api/v3/rest/my/credit
Headers: Authorization: YOUR_API_KEY
{
"return": {
"status": 200,
"message": "اعتبار کاربر"
},
"data": {
"credit": 1500000
}
}
اطلاعات کاربر POST
https://api-payamak.com/api/v3/rest/my
دریافت مشخصات کامل کاربر شامل نام، شرکت، اعتبار، تعرفه و ...
POST https://api-payamak.com/api/v3/rest/my
Headers: Authorization: YOUR_API_KEY
{
"return": {
"status": 200,
"message": "اطلاعات کاربر"
},
"data": {
"fullname": "محمدرضا راهپیما",
"mellicode": "001xxxxxxx",
"shenasname": "001xxxxxxx",
"date": "1375/11/22",
"postcode": "1234567890",
"addr": "تهران _ تهران _ پايتخت",
"expire_time": "1900000000",
"credit": "10000000.000",
"tarrif": "2400",
"type": "نماینده"
}
}
ثبتنام کاربر POST
https://api-payamak.com/api/v3/rest/user/register
ایجاد حساب کاربری جدید در سامانه. (هر مدیر در روز حداکثر ۲ کاربر ثبتنام میکند.)
پارامترهای ورودی (بدنه JSON)
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| uname | String | اجباری | نام کاربری (فقط حروف و اعداد انگلیسی، بدون فاصله و کاراکتر خاص) |
| passwd | String | اجباری | رمز عبور |
| passwd_repeat | String | اجباری | تکرار رمز عبور (باید با passwd یکسان باشد) |
| parent | String | اجباری | نام کاربری مدیر (کسی که کاربر جدید زیرمجموعه او ثبت میشود) |
| mobile | String | اجباری | شماره موبایل (با فرمت 0912... یا 98912+...) |
| melli_code | String | اجباری | کد ملی 10 رقمی، یکتا در سامانه |
| package | Integer | اجباری | شناسه پکیج (بسته تعرفهای که کاربر انتخاب میکند) |
| reseller | Integer | اجباری | وضعیت نمایندگی (0 = نیست یا 1 = هست) |
POST https://api-payamak.com/api/v3/rest/user/register
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"uname": "amirreza",
"passwd": "123456",
"passwd_repeat": "123456",
"parent": "admin",
"mobile": "09121234567",
"melli_code": "1234567890",
"package": 1,
"reseller": 1
}
{
"return": {
"status": 200,
"message": "ثبت نام با موفقیت انجام شد"
}
}
{
"return": {
"status": 429,
"message": "امکان ثبتنام بیش از ۲ کاربر در یک روز برای این مدیر وجود ندارد"
}
}
دفترچه تلفن
لیست دفترچههای تلفن POST
https://api-payamak.com/api/v3/rest/my/phonebook
دریافت لیست تمام دفترچههای تلفن کاربر.
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| name | String | اختیاری | فیلتر بر اساس نام دفترچه |
POST https://api-payamak.com/api/v3/rest/my/phonebook
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"name": "مشتریان"
}
{
"return": {
"status": 200,
"message": "لیست دفترچهها"
},
"entries": [
{
"book_id": 123,
"uname": "user",
"title": "مشتریان",
"count": 45
}
]
}
شمارههای دفترچه POST
https://api-payamak.com/api/v3/rest/phonebook/number
دریافت لیست شمارههای یک دفترچه تلفن.
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| bookId | Integer | اجباری | شناسه دفترچه |
POST https://api-payamak.com/api/v3/rest/phonebook/number
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"book_id": 123
}
{
"return": {
"status": 200,
"message": "شمارههای دفترچه"
},
"entries": [
{
"number_id": 1,
"number": "09123456789"
}
]
}
ایجاد دفترچه تلفن POST
https://api-payamak.com/api/v3/rest/phonebook/new
ایجاد دفترچه تلفن جدید با لیست شمارهها.
پارامترهای ورودی (بدنه JSON)
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| name | String | اجباری | عنوان دفترچه تلفن (یکتا برای هر کاربر) |
| numbers | Array of String | اجباری | لیست شمارههای موبایل (حداقل یک شماره) |
| flag | String | اجباری | برچسب یکتا برای دفترچه (مثلاً "vip" یا "customers") |
POST https://api-payamak.com/api/v3/rest/phonebook/new
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"name": "مشتریان ویژه",
"numbers": ["09123456789", "09123456788"],
"flag": "vip_customers"
}
{
"return": {
"status": 200,
"message": "دفترچه تلفن با موفقیت ایجاد شد"
},
"data": {
"id": 123
}
}
حذف دفترچه تلفن DELETE
https://api-payamak.com/api/v3/rest/phonebook/delete
حذف یک دفترچه تلفن و تمام شمارههای موجود در آن. فقط کاربر مالک میتواند حذف کند.
پارامترهای ورودی (بدنه JSON یا کوئری)
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| book_id | Integer | اجباری | شناسه دفترچه تلفن |
400 بازگردانده میشود.
DELETE https://api-payamak.com/api/v3/rest/phonebook/delete
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"book_id": 123
}
{
"return": {
"status": 200,
"message": "دفترچه تلفن با موفقیت حذف شد"
}
}
افزودن شماره به دفترچه تلفن POST
https://api-payamak.com/api/v3/rest/phonebook/number/add
افزودن یک یا چند شماره موبایل به دفترچه تلفن موجود. فقط کاربر مالک میتواند شماره اضافه کند.
پارامترهای ورودی (بدنه JSON)
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| book_id | Integer | اجباری | شناسه دفترچه تلفن |
| numbers | Array of String | اجباری | لیست شمارههای موبایل (حداقل یک شماره) |
| flag | String | اختیاری | برچسب (کاربردی ندارد) |
400 بازگردانده میشود.
POST https://api-payamak.com/api/v3/rest/phonebook/number/add
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"book_id": 123,
"numbers": ["09123456789", "09123456788"]
}
{
"return": {
"status": 200,
"message": "شمارهها با موفقیت به دفترچه تلفن اضافه شدند"
}
}
حذف شماره از دفترچه تلفن DELETE
https://api-payamak.com/api/v3/rest/phonebook/number/delete
حذف یک یا چند شماره موبایل از دفترچه تلفن. فقط کاربر مالک میتواند شماره حذف کند.
پارامترهای ورودی (بدنه JSON یا کوئری)
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| book_id | Integer | اجباری | شناسه دفترچه تلفن |
| numbers | Array of String | اجباری | لیست شمارههای موبایل برای حذف (حداقل یک شماره) |
| flag | String | اختیاری | برچسب (کاربردی ندارد) |
400 بازگردانده میشود.
DELETE https://api-payamak.com/api/v3/rest/phonebook/number/delete
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"book_id": 123,
"numbers": ["09123456789", "09123456788"]
}
{
"return": {
"status": 200,
"message": "شمارهها با موفقیت از دفترچه تلفن حذف شدند"
}
}
لیست سیاه
لیست سیاه POST
https://api-payamak.com/api/v3/rest/line/blocked/list
دریافت لیست شمارههای مسدود شده برای یک خط.
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| number | String | اجباری | شماره خط |
| startdate | UnixTime | اختیاری | تاریخ شروع |
| page | Integer | اختیاری | شماره صفحه |
| pagesize | Integer | اختیاری | تعداد در هر صفحه |
POST https://api-payamak.com/api/v3/rest/line/blocked/list
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"number": "1000xxxx",
"page": 1,
"pagesize": 200
}
{
"return": {
"status": 200,
"message": "تایید شد"
},
"entries": [
{
"number": "1000xxxx",
"to": "09123456789",
"user": "username",
"setter": "system"
}
],
"current": {
"totalcount": "1",
"currentpage": "1",
"totalpages": "1",
"pagesize": "200"
}
}
افزودن شماره به لیست سیاه POST
https://api-payamak.com/api/v3/rest/line/blocked/add
افزودن یک یا چند شماره موبایل به لیست سیاه یک خط مشخص. (فقط شمارههایی که کاربر به آنها دسترسی دارد قابل افزودن هستند.)
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| number | String | اجباری | شماره خط (خطی که میخواهید شماره را برای آن مسدود کنید) |
| to | Array of String | اجباری | شماره موبایل(های) مورد نظر برای مسدودسازی |
تکراری برگردانده میشوند. حداکثر ۲۰۰ شماره در هر فراخوانی.
POST https://api-payamak.com/api/v3/rest/line/blocked/add
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"number": "21xxxxxxxx",
"to": ["09123456789", "09123456789"]
}
{
"return": {
"status": 200,
"message": "تایید شد"
},
"entries": [
{
"number": "21xxxxxxxx",
"to": "+989123456789",
"status": "افزوده شد"
},
{
"number": "21xxxxxxxx",
"to": "+989123456789",
"status": "تکراری"
}
]
}
کدهای خطا
400– پارامترهایnumberیاtoارسال نشدهاند.400– حداقل یک شماره موبایل برای افزودن وجود ندارد.400– خطا در افزودن شماره به لیست سیاه.401– حساب کاربری غیرفعال یا توکن نامعتبر.
حذف شماره از لیست سیاه POST
https://api-payamak.com/api/v3/rest/line/blocked/remove
حذف یک شماره موبایل از لیست سیاه یک خط مشخص. (فقط شمارههایی که متعلق به کاربر هستند قابل حذف میباشند.)
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| number | String | اجباری | شماره خط (خطی که میخواهید شماره را از لیست سیاه آن حذف کنید) |
| to | String | اجباری | شماره موبایلی که میخواهید از لیست سیاه حذف شود |
400 با پیام "شماره مورد نظر در لیست سیاه یافت نشد" بازگردانده میشود.
POST https://api-payamak.com/api/v3/rest/line/blocked/remove
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"number": "21xxxxxxxx",
"to": "09123456789"
}
{
"return": {
"status": 200,
"message": "شماره با موفقیت از لیست سیاه حذف شد"
}
}
کدهای خطا
400– پارامترهایnumberیاtoارسال نشدهاند.400– شماره مورد نظر در لیست سیاه یافت نشد.400– خطا در حذف شماره از لیست سیاه.401– حساب کاربری غیرفعال یا توکن نامعتبر.
بررسی وجود در لیست سیاه POST
https://api-payamak.com/api/v3/rest/line/blocked/exists
بررسی اینکه آیا یک شماره در لیست سیاه خط مورد نظر وجود دارد یا خیر.
| پارامتر | نوع | اجباری | توضیح |
|---|---|---|---|
| number | String | اجباری | شماره خط |
| to | Array of String | اجباری | شماره موبایل (چندتا) |
POST https://api-payamak.com/api/v3/rest/line/blocked/exists
Headers: Authorization: YOUR_API_KEY
Content-Type: application/json
{
"number": "1000xxxx",
"to": ["09123456789"]
}
{
"return": {
"status": 200,
"message": "تایید شد"
},
"entries": [
{
"number": "1000xxxx",
"to": "09123456789",
"status": "فعال"
}
]
}
کدهای برگشتی
وضعیتهای کاربر
این کدها در پاسخ وبسرویسهایی که جزئیات حساب کاربری را برمیگردانند برگشت داده میشوند.
| کد | توضیح |
|---|---|
| 0 | کاربر در وضعیت فعال قرار دارد. |
| 1 | کاربر مورد بررسی یافت نشد. |
| 2 | کاربر آزمایشی (جهت تست وبسرویس). |
| 3 | کاربر قفل شده است. |
| 4 | عضویت کاربر منقضی شده است. |
| 5 | کاربر هنوز تأیید نشده است. |
| 6 | دسترسی به وبسرویس برای کاربر تعریف نشده است. |
وضعیتهای ثبت کاربر جدید
| کد | توضیح |
|---|---|
| 0 | ثبتنام با موفقیت انجام شد. |
| 10 | نام کاربری نامعتبر است. |
| 11 | شماره موبایل نامعتبر است. |
| 12 | کد ملی نامعتبر است. |
| 13 | ایمیل نامعتبر است. |
| 14 | مدیر کاربر دسترسی کافی ندارد. |
| 15 | نام کاربری قبلاً ثبت شده است. |
| 16 | پکیج درخواستی اشتباه است. |
| 17 | رمز عبور و تکرار آن هماهنگ نیست. |
| 18 | محدودیت ثبتنام (بیش از ۲ کاربر در روز). |
| 19 | کد ملی نامعتبر است. |
وضعیتهای ارسال پیامک
| کد | توضیح |
|---|---|
| 0 | ارسال با موفقیت انجام شد. |
| 21 | تعداد گیرندهها از حد مجاز بیشتر است. |
| 22 | اعتبار کاربر کافی نیست. |
| 23 | شماره فرستنده نامعتبر است. |
| 24 | متن پیام خالی است. |
| 25 | هیچ گیرندهای انتخاب نشده است. |
| 26 | زمان ارسال اشتباه تنظیم شده است. |
| 27 | خطای نامشخص در ارسال (اپراتور). |
| 28 | دادههای ارسالی مغایرت دارد. |
| 29 | الگوی انتخابشده فعال نیست. |
وضعیت گزارشهای پیامکی
| کد | توضیح |
|---|---|
| 0 | گزارش با موفقیت ایجاد شد. |
| 30 | هیچ پیامکی انتخاب نشده است. |
| 31 | هیچ گزارشی موجود نیست. |
| 32 | تعداد شناسهها از حد مجاز فراتر رفته است. |
وضعیت دلیوری (رسید) پیامک
| کد | توضیح |
|---|---|
| 1 | ارسال شده به مخابرات |
| 2 | نرسیده به مخابرات |
| 3 | رسیده به مخابرات |
| 4 | رسیده به گوشی |
| 5 | نرسیده به گوشی |
| 6 | برگشتی |
| 7 | خطای مخابراتی |
| 8 | خطای نامشخص |
| 9 | نامشخص |
| 10 | لیست سیاه |
| 11 | ارسال شد به مخابرات |
| 12 | در صف ارسال |
| 13 | لغو شده |
| 14 | REJECTED |
| 15 | REJECTD |
| 16 | FAILED |
| 17 | UNDELIV |
| 18 | EXPIRED |
| 19 | خطا در پردازش متن پیام |
| 20 | شماره مقصد در لیست سیاه |
| 21 | شماره فرستنده نامعتبر |
| 22 | نقض قوانین و مقررات |
| 23 | فرمت پیام نامعتبر |
| 24 | سایر خطاهای غیرمنتظره |
وضعیت دفترچه تلفن
| کد | توضیح |
|---|---|
| 0 | عملیات با موفقیت انجام شد. |
| 40 | رکوردی با این اطلاعات وجود ندارد. |
| 41 | دفترچه تلفن با این اطلاعات قبلاً وجود دارد. |
| 42 | شمارهای ارسال نشده است. |
| 43 | عملیات شکست خورد. |
| 44 | فیلد flag خالی ارسال شده است. |
| 45 | flag تکراری است. |
سایر کدهای وضعیت
| کد | توضیح |
|---|---|
| 1000 | اشکال در پایگاه داده. |
| 2000 | اشکال در سرور. |