لوگوی sms.ir
ورود / ثبت نام
لوگوی sms.ir
helpImage

REST API

crayon-faq

نسخه جدید SMSPanel

مقدمه

در این بخش مفاهیم و قراردادهای کلی مربوط به استفاده از وب سرویس sms.ir، شرح داده خواهند شد.


HTTP REQUEST HEADER

شما میتوانید برای انجام تنظیمات ضروری و یا شخصی سازی شده، از هدرهای مشخص شده در جدول زیر استفاده نمایید.


عملکرد مقدار کلید
دریافت خروجی با فرمت Json یا Xml application/json یا application/xml ACCEPT
احراز هویت کلید تعریف شده در پنل X-API-KEY


HTTP STATUS CODE

تمامی درخواست های ارسالی دارای HTTP status code های بازگشتی مطابق جدول زیر میباشند. .

توضیح کد وضعیت
عملیات موفقیت آمیز 200
وقوع خطای منطقی 400
وجود خطا در فرآیند احراز هویت 401
تعداد درخواست غیر مجاز 429
خطای غیر منتظره 500


UNIX TIME

واحد مقادیر مربوط به زمان در سطح این سامانه به صورت Unix Time و بر حسب ساعت هماهنگ جهانی (UTC) لحاظ شده است.

مدل بازگشتی

تمامی درخواست های ارسالی دارای مدل بازگشتی یکپارچه با ساختار زیر میباشند.

Response Body
                                        {
                                            "status":1,
                                            "message":"موفق",
                                            "data":[
                                                30004505000027,
                                                10002166593818
                                            ]
                                          }
                        
توضیح مشخصه
کد وضعیت Status
توضیحات وضعیت درخواست Message
دیتای بازگشتی Data


AUTHORIZATION – احراز هویت

شبه منظور هویت سنجی در هنگام استفاده از وب سرویس‌های پیامک سفید ملزم به ارسال کلید خصوصی در بخش هدر درخواست مورد نظر می‌باشید. کلید های خصوصی شما در پنل برنامه نویسان قابل مشاهده و مدیریت میباشند.در هنگام فراخوانی متدهای سامانه کلید خصوصی را با عنوان X-API-KEY در هدر درخواست قرار دهید.

X-API-KEY
                                                                    PN1TVeBeaAehFLJAKU4XdfpsFXsQguYfleO0bV4ceh6diTZid2hRXza3uSkBbDef

                                                                 

ارسال ها

ارسال گروهی

این متد برای ارسال یک متن پیامک به گروهی از شماره موبایل ها مورد استفاده قرار میگیرد. همچنین شما میتوانید با مقداردهی به پارامتر زمان ارسال، از قابلیت ارسال پیامک زمانبندی شده نیز استفاده نمایید.

URL: https://api.sms.ir/v1/send/bulk
                                            Request Method : POST
                                             

حداکثر تعداد مجاز شماره‌های مقصد 100 می‌باشد.
برای ارسال زمانبندی شده، انتخاب زمان گذشته نامعتبر می‌باشد.
برای ارسال زمانبندی شده ، زمان معتبر می تواند در بازه یک ساعت آینده تا حداکثر 365 روز آینده در نظر گرفته شود.

پارامترهای بدنه درخواست

توضیح نوع ارسال مشخصه
شماره خط ارسالی Long اجباری lineNumber
متن پیام کوتاه String اجباری MessageText
شماره موبایل‌ها Array of String اجباری Mobiles
زمان ارسال پیامک (در صورت خالی بودن، ارسال در لحظه انجام می‌شود) UnixTime اختیاری SendDateTime

مدل دیتای بازگشتی

توضیح نوع مشخصه
شناسه یکتای مجموعه ارسال Guid PackId
آرایه ای از شناسه های یکتای هر پیامک Array of Integer MessageIds
اعتبار مصرفی مجموعه ارسال Decimal Cost
Request Body
                                                    {
                                                        "lineNumber": 30004505000017,
                                                        "messageText": "سرویس پیامکی ایده پردازان با 10 سال سابقه همراه شماست",
                                                        "mobiles": [
                                                            "00912xxxx677",
                                                            "0919xxxx904"
                                                        ]
                                                    }
                                                        
                

Response Body
                                                        {
                                                            "status": 1,
                                                            "message": "موفق",
                                                            "data": {
                                                                "packId": "2b99e63c-9bf8-4a21-9bfe-3f72dc1b46f1",
                                                                "messageIds": [
                                                                    86522023,
                                                                    86522024
                                                                ],
                                                                "cost": 2.0
                                                            }
                                                          }
                                                            
                    

در دیتای بازگشتی، مقادیر آرایه MessageIds می‌تواند شامل مقادیر id متناظر آن، Null و یا صفر باشد.
مقدار Null به این معناست که شماره متناظر، غلط است یا متن بیش از حد می باشد.
مقدار صفر به این معناست که شماره متناظر، در لیست سیاه می‌باشد.

این متد برای ارسال یک متن پیامک به گروهی از شماره موبایل ها مورد استفاده قرار میگیرد. همچنین شما میتوانید با مقداردهی به پارامتر زمان ارسال، از قابلیت ارسال پیامک زمانبندی شده نیز استفاده نمایید.

URL: https://api.sms.ir/v1/send/likeToLike
                                                                                        Request Method : POST
                                                    
                                                    

حداکثر تعداد مجاز شماره‌های مقصد 100 می‌باشد.
تعداد شماره موبایل‌ها و متن‌های پیامک باید برابر باشند.
برای ارسال زمانبندی شده، انتخاب زمان گذشته نامعتبر می‌باشد.
برای ارسال زمانبدی شده ، زمان معتبر می تواند در بازه یک ساعت آینده تا حداکثر 365 روز آینده در نظر گرفته شود.

پارامترهای بدنه درخواست

توضیح نوع ارسال مشخصه
شماره خط ارسالی Long اجباری lineNumber
متن پیام کوتاه Array of String اجباری MessageText
شماره موبایل‌ها Array of String اجباری Mobiles
زمان ارسال پیامک (در صورت خالی بودن، ارسال در لحظه انجام می‌شود) UnixTime اختیاری SendDateTime

مدل دیتای بازگشتی

توضیح نوع مشخصه
شناسه یکتای مجموعه ارسال Guid PackId
آرایه ای از شناسه های یکتای هر پیامک Array of Integer MessageIds
اعتبار مصرفی مجموعه ارسال Decimal Cost
Request Body
                                                                                        {
                                                                                            "lineNumber": "30004505000017",
                                                                                            "messageTexts": [
                                                                                                "سرویس پیامکی ایده پردازان با 10 سال سابقه همراه شماست",
                                                                                                "ipdemy.ir  پلتفرم آموزش آنلاین، آکادمی ایده پردازان"
                                                                                            ],
                                                                                            "mobiles": [
                                                                                                "912xxxx677",
                                                                                                "+98919xxxx904"
                                                                                            ]
                                                                                        }
                    
Response Body

                                                                                                {
                                                                                                    "status": 1,
                                                                                                    "message": "موفق",
                                                                                                    "data": {
                                                                                                        "packId": "2b99e63c-9bf8-4a21-9bfe-3f72dc1b46f1",
                                                                                                        "messageIds": [
                                                                                                            86522023,
                                                                                                            86522024
                                                                                                        ],
                                                                                                        "cost": 2.0
                                                                                                    }
                                                                                                  }

در دیتای بازگشتی، مقادیر آرایه MessageIds می‌تواند شامل مقادیر id متناظر آن، Null و یا صفر باشد.
مقدار Null به این معناست که شماره متناظر، غلط است یا متن بیش از حد می باشد.
مقدار صفر به این معناست که شماره متناظر، در لیست سیاه می‌باشد.

حذف ارسال زمانبندی شده

به‌منظور حذف و انصراف از ارسال زمانبندی شده می‌توانید از متد زیر استفاده نمایید. در این متد، شناسه مجموعه ارسال (packId) دریافتی از خروجی ارسال گروهی یا نظیر به نظیر، مورد استفاده قرار می‌گیرد.

URL: https://api.sms.ir/v1/send/scheduled/{packId}

                                                                                Request Method : DELETE
                      

حداکثر تا 3 دقیقه مانده به زمان ارسال زمانبندی شده، مجاز به لغو آن می‌باشید.

پارامترهای بدنه درخواست

توضیح نوع ارسال مشخصه
شناسه مجموعه ارسال Guid اجباری PackId

مدل دیتای بازگشتی

توضیح نوع مشخصه
مقدار اعتبار بازگشتی Decimal ReturnedCreditCount
تعداد پیامک ها Integer SmsCount

URL: https://api.sms.ir/v1/send/scheduled/2b99e63c-9bf8-4a21-9bfe-3f72dc1b46f1

Response Body
                                                                                                        {
                                                                                                            "status": 1,
                                                                                                            "message": "موفق",
                                                                                                            "data": {
                                                                                                              "returnedCreditCount": 10.0,
                                                                                                              "smsCount": 5
                                                                                                            }
                                                                                                          }                                                                                                    

ارسال VERIFY

با استفاده از این متد شما قادر به ارسال پیامک به منظور ارسال کد اعتبارسنجی (verification code)، کد تایید، فاکتور خرید و به طور کلی پیامک‌هایی با اولویت بالا و پارامترهای پویا می‌باشید. از آنجایی که این نوع از ارسال با خطوط خدماتی ارسال میشود امکان دریافت آن توسط افرادی که پیامک‌های تبلیغاتی خود را مسدود کرده‌اند نیز وجود دارد و با اولویت بالایی ارسال خواهد شد.برای استفاده از این نوع ارسال ابتدا قالب پیامک خود را در پنل (بخش ارسال سریع) مشخص نمایید.

URL: https://api.sms.ir/v1/send/verify

Response Body

                                                                                                      Request Method :  POST
                                                                                           

پارامترهای بدنه درخواست

توضیح نوع ارسال مشخصه
شماره موبایل String اجباری Mobile
شناسه قالب (قالب ها از طریق پنل قابل تعریف و مدیریت می‌باشند) Integer اجباری TemplateId
آرایه ای از مدل parameter برای تعیین مقادیر جایگزین شونده در قالب تعریف شده (ساختار مدل parameter در جدول زیر ذکر شده است) Array of Parameter Model اجباری Parameters

مدل Parameter

توضیح نوع ارسال مشخصه
کلید تعیین شده در قالب (بدون در نظر گرفتن # در ابتدا و انتهای آن) String اجباری Name
مقدار کلید تعیین شده برای جایگزینی در قالب پیامک String اجباری Value

مدل دیتای بازگشتی

توضیح نوع مشخصه
شناسه یکتای پیامک Integer MessageId
اعتبار مصرفی ارسال Decimal Cost

Request Body
                                                                                                                {
                                                                                                                    "mobile": "919xxxx904",
                                                                                                                    "templateId": 100000,
                                                                                                                    "parameters": [
                                                                                                                      {
                                                                                                                        "name": "Code",
                                                                                                                        "value": "12345"
                                                                                                                      }
                                                                                                                    ]
                                                                                                                  }
                                                                                                                         
                                                                                                                        
                                                                                
Response Body

                                                                                                                {
                                                                                                                    "status": 1,
                                                                                                                    "message": "موفق",
                                                                                                                    "data": {
                                                                                                                        "messageId": 89545112,
                                                                                                                        "cost": 1.0
                                                                                                                    }
                                                                                                                  }      
                                                                                                                        
                                                                                

گزارش ها

گزارش پیامک دریافت وضعیت

شما میتوانید با استفاده از شناسه یکتای پیامک که پس از انجام هریک از ارسال‌ها دریافت کرده‌اید، با فراخوانی این متد، به دریافت اطلاعات پیامک و همینطور اطلاع از وضعیت (Delivery) آن اقدام نمایید.

URL: https://api.sms.ir/v1/send/{messageId}

                                                            Request Method: GET
                                                        

مدل دیتای بازگشتی

توضیح نوع مشخصه
شناسه یکتای پیامک Integer MessageId
شماره موبایل Long Mobile
متن پیامک String MessageText
زمان ارسال Integer (UnixTime) SendDateTime
شماره خط Long LineNumber
اعتبار کسر شده Decimal Cost
وضعیت دلیوری Nullable Byte DeliveryState
زمان دلیوری Nullable Integer (UnixTime) DeliveryDateTime
URL: https://api.sms.ir/v1/send/89545112

Response Body
                                                                            {
                                                                                "status": 1,
                                                                                "message": "موفق",
                                                                                "data": {
                                                                                    "messageId": 89545112,
                                                                                    "mobile": 912xxxx677,
                                                                                    "messageText": "سرویس پیامکی ایده پردازان با 10 سال سابقه همراه شماست",
                                                                                    "sendDateTime": 1628683626,
                                                                                    "lineNumber": 30004505000017,
                                                                                    "cost": 1.0,
                                                                                    "deliveryState": 1,
                                                                                    "deliveryDateTime": 1628683629
                                                                                }
                                                                              }
                                                                                    
                                            

گزارش مجموعه ارسال های روز

شما می‌توانید با استفاده از این گزارش اطلاعات کلی مجموعه ارسال‌های روز جاری را دریافت نمایید.

URL: https://api.sms.ir/v1/send/pack
                Request Method : GET
            

پارامترهای درخواست

توضیح نوع ارسال مشخصه
تعداد آیتم‌های در صفحه (مقدار پیشفرض 100 می‌باشد) Integer اختیاری PageSize
شماره صفحه درخواستی (مقدار پیشفرض 1 می‌باشد) Integer اختیاری PageNumber

مدل دیتای بازگشتی (آرایه‌ای از مدل زیر)

توضیح نوع مشخصه
شناسه مجموعه GUID packId
تعداد مخاطبان Number recipientCount
زمان ایجاد Number creationDateTime
URL: https://api.sms.ir/v1/send/pack

Response Body
                                                                                                            {
                                                                                                                "status": 1,
                                                                                                                "message": "موفق",
                                                                                                                "data": [{
                                                                                                                    "packId": e7c09e23f0db4834b9bcb79e7b054f4c,
                                                                                                                    "recipientCount": 100,
                                                                                                                    "creationDateTime": 1628683626,
                                                                                                                },{
                                                                                                                   "packId": 0cf3017fd9d84babbb5ed5579104dab2,
                                                                                                                    "recipientCount": 200,
                                                                                                                    "creationDateTime": 1628683626,
                                                                                                                }]
                                                                                                              }
                                                                                                                              
                                            

گزارش مجموعه ارسال

شما میتوانید با استفاده از شناسه مجموعه ارسال، گزارشی از پیامک‌های ارسالی در آن درخواست به‌ همراه وضعیت‌هایشان را دریافت نمایید.

URL: https://api.sms.ir/v1/send/pack/{packId}
                                                                Request Method : GET
                                                            

پارامترهای درخواست

توضیح نوع ارسال مشخصه
شناسه مجموعه ارسال Guid اجباری PackId

مدل دیتای بازگشتی (آرایه‌ای از مدل زیر)

توضیح نوع مشخصه
شناسه یکتای پیامک Integer MessageId
شماره موبایل Long Mobile
متن پیامک String MessageText
زمان ارسال Integer (UnixTime) SendDateTime
شماره خط Long LineNumber
اعتبار کسر شده Decimal Cost
وضعیت دلیوری Nullable Byte DeliveryState
زمان دلیوری Nullable Integer (UnixTime) DeliveryDateTime
URL: https://api.sms.ir/v1/send/pack/bdec19c9-2736-4095-8ef1-ea21afe3771f

Response Body

                                                                        {
                                                                            "status": 1,
                                                                            "message": "موفق",
                                                                            "data": [{
                                                                                "messageId": 89545112,
                                                                                "mobile": 912xxxx677,
                                                                                "messageText": "سرویس پیامکی ایده پردازان با 10 سال سابقه همراه شماست",
                                                                                "sendDateTime": 1628683626,
                                                                                "lineNumber": 30004505000017,
                                                                                "cost": 1.0,
                                                                                "deliveryState": 1,
                                                                                "deliveryDateTime": 1628683629
                                                                            },{
                                                                                "messageId": 89545113,
                                                                                "mobile": 919xxxx378,
                                                                                "messageText": "ipdemy.ir پلتفرم آموزش آنلاین، آکادمی ایده پردازان",
                                                                                "sendDateTime": 1628683626,
                                                                                "lineNumber": 30004505000017,
                                                                                "cost": 1.0,
                                                                                "deliveryState": 3,
                                                                                "deliveryDateTime": 1628683625
                                                                            }]
                                                                          }
                                                                            
                                    

گزارش ارسال های روز

شما استفاده از متد زیر، گزارشی از ارسال‌های انجام شده در روز جاری قابل دریافت است.

URL: https://api.sms.ir/v1/send/live

                                                             Request Method : GET
                                    

پارامترهای درخواست

توضیح نوع ارسال مشخصه
تعداد آیتم‌های در صفحه (حداکثر:100 ، پیش فرض: 100) Integer اختیاری PageSize
شماره صفحه درخواستی (مقدار پیشفرض 1 می‌باشد) Integer اختیاری PageNumber

مدل دیتای بازگشتی (آرایه‌ای از مدل زیر)

توضیح نوع مشخصه
شناسه یکتای پیامک Integer MessageId
شماره موبایل Long Mobile
متن پیامک String MessageText
زمان ارسال Integer (UnixTime) SendDateTime
شماره خط Long LineNumber
اعتبار کسر شده Decimal Cost
وضعیت دلیوری Nullable Byte DeliveryState
زمان دلیوری Nullable Integer (UnixTime) DeliveryDateTime
URL: https://api.sms.ir/v1/send/live?pageSize=25&pageNumber=3

Response Body
                                                                {
                                                                    "status": 1,
                                                                    "message": "موفق",
                                                                    "data": [{
                                                                        "messageId": 89545112,
                                                                        "mobile": 912xxxx677,
                                                                        "messageText": "سرویس پیامکی ایده پردازان با 10 سال سابقه همراه شماست",
                                                                        "sendDateTime": 1628683626,
                                                                        "lineNumber": 30004505000017,
                                                                        "cost": 1.0,
                                                                        "deliveryState": 1,
                                                                        "deliveryDateTime": 1628683629
                                                                    },{
                                                                        "messageId": 89545113,
                                                                        "mobile": 919xxxx378,
                                                                        "messageText": "ipdemy.ir پلتفرم آموزش آنلاین، آکادمی ایده پردازان",
                                                                        "sendDateTime": 1628683626,
                                                                        "lineNumber": 30004505000017,
                                                                        "cost": 1.0,
                                                                        "deliveryState": 3,
                                                                        "deliveryDateTime": 1628683625
                                                                    }]
                                                                }
                                                                               
                                                                    
                            

گزارش ارسال های آرشیو شده

شما فراخوانی متد زیر، گزارشی از ارسال‌های انجام شده در گذشته (تا انتهای روز قبل)، را دریافت خواهید نمود.

URL: https://api.sms.ir/v1/send/archive

             Request Method :  GET   
        

پارامترهای درخواست

توضیح نوع ارسال مشخصه
از تاریخ Integer (UnixTime) اختیاری FromDate
تا تاریخ Integer (UnixTime) اختیاری ToDate
تعداد آیتم‌های در صفحه (حداکثر:100 ، پیش فرض: 100) Integer اختیاری PageSize
شماره صفحه درخواستی (مقدار پیشفرض 1 می‌باشد) Integer اختیاری PageNumber

مدل دیتای بازگشتی (آرایه‌ای از مدل زیر)

توضیح نوع مشخصه
شناسه یکتای پیامک Integer MessageId
شماره موبایل Long Mobile
متن پیامک String MessageText
زمان ارسال Integer (UnixTime) SendDateTime
شماره خط Long LineNumber
اعتبار کسر شده Decimal Cost
وضعیت دلیوری Nullable Byte DeliveryState
زمان دلیوری Nullable Integer (UnixTime) DeliveryDateTime
URL: https://api.sms.ir/v1/send/archive?fromDate=1613465574&toDate=1623805200

Response Body
                                                                        {
                                                                            "status": 1,
                                                                            "message": "موفق",
                                                                            "data": [{
                                                                                "messageId": 89545112,
                                                                                "mobile": 912xxxx677,
                                                                                "messageText": "سرویس پیامکی ایده پردازان با 10 سال سابقه همراه شماست",
                                                                                "sendDateTime": 1628583626,
                                                                                "lineNumber": 30004505000017,
                                                                                "cost": 1.0,
                                                                                "deliveryState": 1,
                                                                                "deliveryDateTime": 1628683629
                                                                            },{
                                                                                "messageId": 89545113,
                                                                                "mobile": 919xxxx378,
                                                                                "messageText": "ipdemy.ir پلتفرم آموزش آنلاین، آکادمی ایده پردازان",
                                                                                "sendDateTime": 1628583626,
                                                                                "lineNumber": 30004505000017,
                                                                                "cost": 1.0,
                                                                                "deliveryState": 3,
                                                                                "deliveryDateTime": 1628683625
                                                                            },{
                                                                                "messageId": 89545114,
                                                                                "mobile": 921xxxx432,
                                                                                "messageText": "HyperBox.irفروشگاه اینترنتی اسباب بازی و عروسک ",
                                                                                "sendDateTime": 1628583626,
                                                                                "lineNumber": 30004505000017,
                                                                                "cost": 1.0,
                                                                                "deliveryState": 1,
                                                                                "deliveryDateTime": 1628683669
                                                                            }]
                                                                        ]
                                                                        }
                                                                       
                                                            
                    

گزارش تازه ترین پیامک های دریافتی

شما می‌توانید با استفاده از این متد، تازه‌ترین پیامک‌های دریافتی را مشاهده نمایید. لازم به ذکر است هر پیامک دریافتی تنها یک مرتبه توسط این متد قابل دستیابی میباشد و پس از آن به دلیل قرار گرفتن در حالت خوانده شده قابل دسترسی مجدد توسط این متد نمی‌باشند.

URL: https://api.sms.ir/v1/receive/latest

                                                                                                Request Method : GET
                                                                                            

پارامترهای درخواست

توضیح نوع ارسال مشخصه
تعداد درخواستی (حداکثر تعداد درخواستی و مقدار پیشفرض 100 می‌باشد) Integer اختیاری Count

مدل دیتای بازگشتی (آرایه‌ای از مدل زیر)

توضیح نوع مشخصه
ششماره موبایل ارسال کننده Long Mobile
متن پیامک String MessageText
شماره خط دریافت کننده Long Number
زمان دریافت Integer (UnixTime) ReceivedDateTime

URL: https://api.sms.ir/v1/receive/latest?count=50

Response Body
                                                                                    {
                                                                                        "status": 1,
                                                                                        "message": "موفق",
                                                                                        "data": [
                                                                                            {
                                                                                                "messageText": "HyperBox.irفروشگاه اینترنتی اسباب بازی و عروسک",
                                                                                                "number": 30004505000017,
                                                                                                "mobile": 912xxxx002,
                                                                                                "receivedDateTime": 1628683625
                                                                                            }
                                                                                        ]
                                                                                      }
                                                                                               
                                                                        
                                                                                        

گزارش پیامک های دریافتی روز

با فراخوانی متد زیر، گزارش پیامک‌های دریافتی روز جاری (اعم از خوانده شده و نشده) قابل دستیابی می‌باشد.

در آغازین ساعات روز، گزارش پیام های دریافتی روز گذشته نیز با فراخوانی این متد قابل دریافت می‌باشد.

URL: https://api.sms.ir/v1/receive/live

                                                              Request Method :  GET
                                                            

پارامترهای درخواست

توضیح نوع ارسال مشخصه
تعداد آیتم‌های در صفحه (حداکثر:100 ، پیش فرض: 100) Integer اختیاری PageSize
شماره صفحه درخواستی (مقدار پیشفرض 1 می‌باشد) Integer اختیاری PageNumber
مرتب سازی بر اساس تاریخ دریافت (پیش فرض به صورت صعودی، با مقدار False) Boolean اختیاری sortByNewest

مدل دیتای بازگشتی (آرایه‌ای از مدل زیر)

توضیح نوع مشخصه
شماره موبایل ارسال کننده Long Mobile
متن پیامک String MessageText
شماره خط دریافت کننده Long Number
زمان دریافت Integer (UnixTime) ReceivedDateTime

URL: https://api.sms.ir/v1/receive/live?pageSize=20&pageNumber=3&sortByNewest=false

Response Body

                                                                        {
                                                                            "status": 1,
                                                                            "message": "موفق",
                                                                            "data": [
                                                                                {
                                                                                    "messageText": "HyperBox.irفروشگاه اینترنتی اسباب بازی و عروسک",
                                                                                    "number": 30004505000017,
                                                                                    "mobile": 912xxxx002,
                                                                                    "receivedDateTime": 1628683625
                                                                                }
                                                                            ]
                                                                          }
                                                       
                                
            

گزارش پیامک های دریافتی آرشیو شده

با فراخوانی متد زیر، گزارشی از پیامک‌های دریافتی در گذشته (تا انتهای روز قبل)، را مشاهده خواهید نمود.

URL: https://api.sms.ir/v1/receive/archive

                                                             Request Method : GET
                                                            


پارامترهای درخواست

توضیح نوع ارسال مشخصه
از تاریخ Integer (UnixTime) اختیاری FromDate
تا تاریخ Integer (UnixTime) اختیاری ToDate
تعداد آیتم‌های در صفحه (حداکثر:100 ، پیش فرض: 100) Integer اختیاری PageSize
شماره صفحه درخواستی (مقدار پیشفرض 1 می‌باشد) Integer اختیاری PageNumber

مدل دیتای بازگشتی (آرایه‌ای از مدل زیر)

توضیح نوع مشخصه
شماره موبایل ارسال کننده Long Mobile
متن پیامک String MessageText
شماره خط دریافت کننده Long Number
زمان دریافت Integer (UnixTime) ReceivedDateTime

URL: https://api.sms.ir/v1/receive/archive?fromDate=1613465574&toDate=1623805200

Response Body

                                                                        {
                                                                            "status": 1,
                                                                            "message": "موفق",
                                                                            "data": [
                                                                                {
                                                                                    "messageText": "HyperBox.irفروشگاه اینترنتی اسباب بازی و عروسک",
                                                                                    "number": 30004505000017,
                                                                                    "mobile": 912xxxx002,
                                                                                    "receivedDateTime": 1628683625
                                                                                }
                                                                            ]
                                                                          }
                                                                                 

تنظیمات

دریافت مقدار اعتبار فعلی

برای مشاهده مقدار اعتبار فعلی از متد زیر استفاده نمایید.

URL: https://api.sms.ir/v1/credit
                                                                    Request Method : GET
        

دیتای بازگشتی

توضیح نوع
مقدار اعتبار Decimal

URL: https://api.sms.ir/v1/credit
Response Body

                                                                            {
                                                                                "status": 1,
                                                                                "message": "موفق",
                                                                                "data": 165.3
                                                                              }
                                                                                     

دریافت لیست خطوط

با استفاده از این متد، لیست خطوط آماده استفاده برای ارسال، قابل مشاهده است.

URL: https://api.sms.ir/v1/line

                                                                                                            Request Method : GET
                                                                                            


دیتای بازگشتی (آرایه ای از Long)

توضیح نوع
شماره خط Long

URL: https://api.sms.ir/v1/line

                                                                                                    {
                                                                                                        "status": 1,
                                                                                                        "message": "موفق",
                                                                                                        "data": [10002155613464, 30004505000017]
                                                                                                      }
                                                                                                             

جدول کدهای وضعیت


کدهای وضعیت های ارسال

توضیح کد وضعیت
عملیات با موفقیت انجام شد 1
مشکلی در سامانه رخ داده است، لطفا با پشتیبانی در تماس باشید شد 0
کلید وب سرویس نامعتبر است شد 10
کلید وب سرویس غیرفعال است 11
کلید وب‌ سرویس محدود به IP‌های تعریف شده می‌باشد 12
حساب کاربری غیر فعال است 13
حساب کاربری در حالت تعلیق قرار دارد 14
تعداد درخواست بیشتر از حد مجاز است 20
شماره خط نامعتبر میباشد 101
اعتبار کافی نمیباشد 102
درخواست شما دارای متن (های) خالی است 103
درخواست شما دارای موبایل (های) نادرست است 104
تعداد موبایل ها بیشتر از حد مجاز (100 عدد) میباشد 105
تعداد متن ها بیشتر از حد مجاز (100 عدد) میباشد 106
لیست موبایل ها خالی میباشد 107
لیست متن ها خالی میباشد 108
زمان ارسال نامعتبر میباشد 109
تعداد شماره موبایل ها و تعداد متن ها برابر نیستند 110
با این شناسه ارسالی ثبت نشده است 111
رکوردی برای حذف یافت نشد 112
قالب یافت نشد 113
طول رشته مقدار پارامتر، بیش از حد مجاز (25 کاراکتر) می‌باشد 114
شماره موبایل(ها) در لیست سیاه سامانه می‌باشند 115
نام پارامتر نمی‌تواند خالی باشد 116
متن ارسال شده مورد تایید نمی‌باشد 117
تعداد پیام ها بیش از حد مجاز می باشد. 118

کدهای وضعیت دلیوری

توضیح کد وضعیت
رسیده به گوشی 1
نرسیده به گوشی 2
پردازش در مخابرات 3
نرسیده به مخابرات 4
رسیده به مخابرات 5
خطا 6
لیست سیاه 7

ارسال از طریق URL

این متد برای ارسال پیامک از طریق URL مورد استفاده قرار می‌گیرد. برای ارسال کافی است پارامترهای مورد نیاز را در قالب Query Params در آدرس مشخص شده قرار دهید.

URL: https://api.sms.ir/v1/send
                                                                            Request Method : GET
                                                                             

پارامترهای بدنه درخواست

توضیح نوع ارسال مشخصه
نام کاربری String اجباری Username
کلید خصوصی (کلیدهای خصوصی شما در پنل برنامه‌نویسان قابل مشاهده و مدیریت می‌باشند.) String اجباری Password
شماره خط Long اجباری Line
شماره موبایل String اجباری Mobile
متن پیامک String اجباری Text

مدل دیتای بازگشتی

توضیح نوع مشخصه
شناسه یکتای پیامک Integer MessageId
اعتبار مصرفی ارسال Decimal Cost
Request URL
                                                                             https://api.sms.ir/v1/send?username=MY_USERNAME&password=MY_APIKEY&line=LINE_NUMBER&mobile=MOBILE&text="MESSAGE_TEXT"

                                                

Response Body
    {
    "status": 1,
    "message": "موفق",
    "data": {
        "messageId": 89545112,
        "cost": 1.0
    }
  }

                                                    
مشاوره رایگان ۰۲۱۲۸۵۳