برخی از ارور هایی که در وب سرویس ها داده میشود به شرح زیر میباشد

مقادیر ذکر شده در جدول برای تمامی متدهایی که پارامتر dargahha یا dargah دارند قابل استفاده میباش

وضعیت پیامک ها در سیستم به شرح زیر میباشد

با استفاده از این سرویس پیامک دریافتی شما بلافاصله پس از دریافت به آدرسی که در تنظیمات مشخص کرده اید به صورت POST ارسال میشود.

تذکر تمامی پارامتر هایی که خود شما در آدرس قرار میدهید به صورت GET برای شما ارسال میشوند و فقط پارامتر های زیر که غیر قابل تغییر هستند به صورت POST ارسال میشوند!

تمامی تاریخ ها بر اساس unix timestamp میباشد

ای تاریخ شامل یک عدد میباشد که از تاریخ January 1st, 1970 at UTC شروع شده است

Example: 1493532518 (ISO 8601: 2017-04-30T06:08:38Z)

این مدل تاریخ قابل استفاده در تمامی زبانهای برنامه نویسی است

برای اطلاعات بیشتر بر روی این نوشته کلیک نمایید PHP time() Python import time; time.time() Ruby Time.now (or Time.new). To display the epoch: Time.now.to_i Perl time Java long epoch = System.currentTimeMillis()/1000; C# var epoch = (DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalSeconds; Objective-C [[NSDate date] timeIntervalSince1970]; (returns double) or NSString *currentTimestamp = [NSString stringWithFormat:@"%f", [[NSDate date] timeIntervalSince1970]]; C++11 double now = std::chrono::duration_cast<std::chrono::milliseconds>(std::chrono::system_clock::now().time_since_epoch()).count(); VBScript/ASP DateDiff("s", "01/01/1970 00:00:00", Now()) AutoIT _DateDiff('s', "1970/01/01 00:00:00", _NowCalc()) Delphi Epoch := DateTimetoUnix(Now); Tested in Delphi 2010. R as.numeric(Sys.time()) Erlang/OTP erlang:system_time(seconds). (version 18+), older versions: calendar:datetime_to_gregorian_seconds(calendar:universal_time())-719528*24*3600. MySQL SELECT unix_timestamp(now()) PostgreSQL SELECT extract(epoch FROM now()); SQLite SELECT strftime('%s', 'now'); Oracle PL/SQL SELECT (CAST(SYS_EXTRACT_UTC(SYSTIMESTAMP) AS DATE) - TO_DATE('01/01/1970','DD/MM/YYYY')) * 24 * 60 * 60 FROM DUAL; SQL Server SELECT DATEDIFF(s, '1970-01-01 00:00:00', GETUTCDATE()) IBM Informix SELECT dbinfo('utc_current') FROM sysmaster:sysdual; JavaScript Math.round(new Date().getTime()/1000.0) getTime() returns time in milliseconds. Visual FoxPro DATETIME() - {^1970/01/01 00:00:00} Warning: time zones not handled correctly Adobe ColdFusion <cfset epochTime = left(getTickcount(), 10)> Go time.Now().Unix() Tcl/Tk clock seconds Unix/Linux Shell date +%s PowerShell [int][double]::Parse((Get-Date (get-date).touniversaltime() -UFormat %s)) Other OS's Command line: perl -e "print time" (If Perl is installed on your system)

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

SOAP مخفف Simple Object Access Protocol است. SOAP یک پادمان مبتنی بر XML است، برای رد و بدل کردن اطلاعات بین برنامه ها. اطلاعات در SOAP به صورت پیام (Message) و از طریق پادمان‏های موجود در اینترنت مانند HTTP منتقل می‏شود (SOAP در سایر پادمان ها، مانند SMTP یا MIME نیز قابل استفاده است). به زبان ساده‏تر، SOAP یک پادمان است برای دستیابی به یک سرویس ارایه شده در وب (Web Service). آخرین نسخه SOAP، نسخه 1.2 می‏باشد

آدرس وب سرویس SOAP

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

نام متد:

sms_receive

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

نام متد:

send_sms

REST بهترین روش برای وب سرویس ها میباشد و در تمامی زبان های برنامه نویسی قابلیت پیاده سازی دارد

در این روش خروجی بر اساس JSON میباشد ( توضیحات بیشتر در مورد JSON)

در این روش شما میتوانید با یکی از متد های POST یا GET اطلاعات را برای وب سرویس ارسال نمایید

آدرس وب سرویس رست به صورت زیر میباشد :

http://smssama.ir/webservice/rest/

در تمامی فانکشن ها میتوانید به جای login_username و login_password از api_key استفاده نمایید

api_key را از قسمت تنظیمات در پنل کاربری میتوانید بدست آورید

api_key برای همیشه ثابت است و فقط برای وب سرویس REST استفاده میشود

مثال :

http://smssama.ir/webservice/rest/sms_send?note_arr[]=سلام&api_key=API_KEY&receiver_number=09132677411&sender_number=10007666

برای پاسخ تمامی متد ها result با ۲ مقدار true و false وجود دارند که مقدار false نشانه ی ناموفق بودن عملیات است

به طور مثال وقتی نام کاربری و رمز عبور اشتباه باشد چنین خطایی دریافت خواهید کرد

{"result":false,"error":"error_login_user_not_found"}

از این متد برای دریافت اطلاعات کاربری و شماره های اختصاصی و میزان شارژ استفاده می شود.

نام متد:

user_info

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/user_info?

مثال :

http://smssama.ir/webservice/rest/user_info?login_username=USERNAME&login_password=PASSWORD

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/user_info?login_username=USERNAME&login_password=PASSWORD HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"list":{"username":"admin_USERNAME","fullname":"ارسال","email":"myemailt@yahoo.com","mobile":"09132677411","cash":"3212509","date":"1389\/5\/5 00:46","date_expire":"1394\/2\/24 00:00"},"number":{"result":true,"list_user":[{"number":"10007666000000","order":"shop_serial,label_reply,nobat,tanasob,book_serial,khatme_ghoran,lottery,nobatdehi,tahlilgar,bime,mobile_control,takrim,takhfif"},{"number":"30007666204100","order":""}]}}

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

نام متد:

sms_send

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_send?

مثال :

http://smssama.ir/webservice/rest/sms_send?note_arr[]=سلام&login_username=USERNAME&login_password=PASSWORD&receiver_number=09132677411&sender_number=10007666

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_send?note_arr=test&login_username=USERNAME&login_password=PASSWORD&receiver_number=09132677411&sender_number=10007666 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : در این پاسخ 92943923 شناسه ی پیامک در سیستم ما میباشد که برای دلیوری به آن احتیاج دارید
مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"list":[92943923]}

به تعداد گیرنده ها به شما شناسه ی پیامک داده خواهد شد که شناسه هابا علامت کاما , از هم جدا شده اند مانند :

{"result":true,"list":[92943981,92943982]}

از این متد برای ارسال پیامک استفاده می شود.تمامی پارامتر ها به صورت POST برای آدرس ارسال میشود

درگاه : smssama.ir

لینک ارسال :

http://smssama.ir/webservice/rest/sms_send?

نام کاربری : نام کاربری ورود به سامانه ارسال پیامک

رمز عبور : رمز عبور ورود به سامانه ارسال پیامک

فرستنده : خط اختصاصی سامانه ارسال پیام کوتاه خود

پس از واردنمودن اطلاعات بالا در قسمت تنظیمات مدیریتی، کامپیوتر متصل به اینترنت را انتخاب و تنظیمات را ذخیره نمایید.

پس از ایجاد درگاه ارسال پیامک smssama.ir می بایست به قسمت تنظیمات پیشرفته در همان تنظیمات مدیریتی رفته و اطلاعات آن را تغییر دهید:

Username را به عبارت login_username تغییر دهید.

مقدار password را به مقدار login_password تغییر دهید .

عبارت مربوط به TO را به receiver_number به روز رسانی کنید.

مقدار from می بایست کاملا تغییر کرده و sender_number شود.

در انتها mesage را به note_arr تغییر دهید.

سپس تنظیمات را به روز رسانی نموده و در زمان ارسال پیامک درگاه smssama.ir را انتخاب نمایید.

برای بررسی ارسال نیز به تنظیمات مدیریتی رفته و تقویم کاری را انتخاب نمایید.

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

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

از این متد برای اطلاع از وضعیت پیامک های ارسال شده استفاده می شود.
متد sms_deliver_online نیز دقیقا مانند همین متد میباشد و تنها تفاوت آن این است که sms_deliver_online در همان لحظه از اپراتور نهایی ارسال کننده ی پیامک وضعیت پیامک شما را دریافت میکند اما sms_deliver وضعیت ها را هر ۳۰ دقیقه یک بار به روز رسانی میکند و در واقع نتایج بررسی های قبلی را به شما نمایش میدهد

نام متد:

sms_deliver

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_deliver?

مثال :

http://smssama.ir/webservice/rest/sms_deliver?smsid[]=92943981&smsid[]=92943982&dargah=1000

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_deliver?smsid[]=92943981&smsid[]=92943982&dargah=1000 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : در این پاسخ 92943981 شناسه ی پیامک در سیستم ما میباشد که 5 برای دلیوری آن داده شده است
عدد ۵ به معنای بلک لیست میباشد جدول وضعیت ها

{"result":true,"list":{"92943981":"5","92943982":"1"}}

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

نام متد:

user_cat_add

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/user_cat_add?

مثال :

http://smssama.ir/webservice/rest/user_cat_add?login_username=USERNAME&login_password=PASSWORD&title=دوستان

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/user_cat_add?login_username=USERNAME&login_password=PASSWORD&title=دوستان HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : addedid شناسه ی گروه جدید ایجاد شده در سیستم ما میباشد
مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"addedid":"160335"}

نمونه پاسخ عملیات ناموفق :

{"result":false,"error":"error_complete_all"}

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

نام متد:

user_cat_list

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/user_cat_list?

مثال :

http://smssama.ir/webservice/rest/user_cat_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/user_cat_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"list":[{"date":"1481012960","date_fa":"1395\/9\/16 11:59","id":"156487","number":"1942","title":"علیپور"},{"date":"1475328506","date_fa":"1395\/7\/10 16:58","id":"153034","number":"130","title":"مراتب 2"}]}

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

نام متد:

user_cat_info

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/user_cat_info?

مثال :

http://smssama.ir/webservice/rest/user_cat_info?login_username=USERNAME&login_password=PASSWORD&id=156487

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/user_cat_info?login_username=USERNAME&login_password=PASSWORD&id=156487 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"list":{"id":"156487","userid":"48","title":"علیپور","date":"1481012960","number":"1942","adminid":"1","receive_catid":"0","parentid":"0"}}

نمونه پاسخ عملیات ناموفق :

{"result":false,"error":"error_not_found"}

از این متد برای اضافه کردن شماره ی جدید به دفترتلفن استفاده می شود.

نام متد:

sms_number_add

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_number_add?

مثال :

http://smssama.ir/webservice/rest/sms_number_add?login_username=USERNAME&login_password=PASSWORD&catid=156487&repeat=3&number=09132677411&fullname=تست&gender=1&fullname_en=test&gender_en=1&blacklist_no_check=true

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_number_add?login_username=USERNAME&login_password=PASSWORD&catid=156487&repeat=3&number=09132677411&fullname=تست&gender=1&fullname_en=test&gender_en=1&blacklist_no_check=true HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"addedid":"35719269"}

نمونه پاسخ عملیات ناموفق :

{"result":false,"error":"شماره نامعتبر میباشد \n\t\t\t[کد۰]\n\t\t\t"}
{"result":false,"error":" شماره ی +989132677411 قبلا در بخش های دیگر ثبت شده است"}
{"result":false,"error":"بخش انتخاب شده مربوط به شما نمیباشد."}

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

نام متد:

sms_number_list

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_number_list?

مثال :

http://smssama.ir/webservice/rest/sms_number_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_number_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"list":[{"id":"36819915","userid":"48","fullname":"09357746152","number":"+989357746152","date":"1501585658","catid":"147633","gender":"0","fullname_en":"","gender_en":"0","json_config":""},{"id":"36585956","userid":"48","fullname":"حسن خواجه","number":"+989389994672","date":"1499673540","catid":"147633","gender":"2","fullname_en":"khaje","gender_en":"2","json_config":""},{"id":"24888553","userid":"48","fullname":"+989360006291","number":"+989360006981","date":"1464249061","catid":"147633","gender":"0","fullname_en":"","gender_en":"0","json_config":""}],"count":0}

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

نام متد:

sms_number_update

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_number_update?

مثال :

http://smssama.ir/webservice/rest/sms_number_update?catid=30

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_number_update?catid=30 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"list":"30","count":"69"}

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

نام متد:

sms_receive_list

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_receive_list?

مثال :

http://smssama.ir/webservice/rest/sms_receive_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_receive_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"list":[{"id":"1227955","sender_number":"09135580123","receiver_number":"3000053335","date":"1493483544","date_fa":"1396\/2\/9 21:02","catid":"0","read":"0","note":"خانم شیرانی"},{"id":"1227938","sender_number":"09300706012","receiver_number":"3000053335","date":"1493481719","date_fa":"1396\/2\/9 20:31","catid":"0","read":"0","note":"داداشی اینقد بچه کوچیک اونجا بود مشکل کند ذهنی و عقب افتادگی داشتن اصن ..."}]}

از این متد برای تغییر وضعیت خوانده شدن پیام های دریافتی استفاده می شود.

نام متد:

sms_receive_change_read

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_receive_change_read?

مثال :

http://smssama.ir/webservice/rest/sms_receive_change_read?login_username=USERNAME&login_password=PASSWORD&read=1&id[]=156487

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_receive_change_read?login_username=USERNAME&login_password=PASSWORD&read=1&id[]=156487 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"list":{"id":"156487","userid":"48","title":"علیپور","date":"1481012960","number":"1942","adminid":"1","receive_catid":"0","parentid":"0"}}

نمونه پاسخ عملیات ناموفق :

{"result":false,"error":"error_not_found"}

از این متد برای دریافت لیست کلمات کلیدی مورد استفاده در منشی پیامک و مسابقه و نظرسنجی استفاده می شود.

نام متد:

label_list

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/label_list?

مثال :

http://smssama.ir/webservice/rest/label_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/label_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"list":[{"id":"34860","label":"5","title":"تست","adminid":"1","userid":"48","kind":"3","refferid":"470","date":"1383648729","state":"0","number":"30004712666300","date_start":"1383652260","date_end":"1383735060","repeat":"1","hit":"0","note":"تست","catid":"0","catid_delete":"0","date_fa":"1392\/8\/14 14:22"}],"count":1}

مفهوم label کلمه ی کلیدی مورد نظر میباشد

مفهوم count تعداد دفعات استفاده از این کلمه توسط کاربران میباشد

مفهوم kind موجود در پاسخ در جدول زیر آمده است

از این متد برای ایجاد کلمات کلیدی مورد استفاده در منشی پیامک و مسابقه و نظرسنجی استفاده می شود.

نام متد:

label_new

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/label_new?

مثال :

http://smssama.ir/webservice/rest/label_new?note=ok&login_username=USERNAME&login_password=PASSWORD&title=test&label=1&reply=ok&kind=1&repeat=2&number=10007666

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/label_new?note=ok&login_username=USERNAME&login_password=PASSWORD&title=test&label=1&reply=ok&kind=1&repeat=2&number=10007666 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"addedid":"32908"}

از این متد برای ویرایش کلمات کلیدی مورد استفاده در منشی پیامک و مسابقه و نظرسنجی استفاده می شود.

نام متد:

label_edit

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/label_edit?

مثال :

http://smssama.ir/webservice/rest/label_edit?id=123¬e=ok&login_username=USERNAME&login_password=PASSWORD&title=test&label=1&reply=ok&repeat=2&number=10007666

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/label_edit?note=ok&id=123&login_username=USERNAME&login_password=PASSWORD&title=test&label=1&reply=ok&repeat=2&number=10007666 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true}

از این متد برای حذف کلمه ی کلیدی استفاده می شود.

نام متد:

label_remove

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/label_remove?

مثال :

http://smssama.ir/webservice/rest/label_remove?login_username=USERNAME&login_password=PASSWORD&id=156487

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/label_remove?login_username=USERNAME&login_password=PASSWORD&id=156487 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true}

نمونه پاسخ عملیات ناموفق :

{"result":false,"error":"error_not_found"}

از این متد برای ایجاد لینک ورود مدت دارد یک بار مصرف استفاده می شود.

نام متد:

user_once_login

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/user_once_login?

مثال :

http://smssama.ir/webservice/rest/user_once_login?login_username=USERNAME&login_password=PASSWORD&expire=2

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/user_once_login?login_username=USERNAME&login_password=PASSWORD&expire=2 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"url":"http:\/\/sms123.ir\/user_once_login.php?id=2&md5=XXXXXXX&token=XXXXXXXXXXXXXXXXX"}

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

نام متد:

sms_bank_list

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_bank_list?

مثال :

http://smssama.ir/webservice/rest/sms_bank_list?bank_type=postal_code

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_bank_list?bank_type=postal_code HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"bank":{"tehran":"تهران","karaj":"کرج","esfahan":"اصفهان","mashhad":"مشهد","khorasan":"خراسان","shiraz":"شیراز","kordestan":"کردستان","gilan":"گیلان","ardebil":"اردبیل","tabriz":"تبریز","tabriz_2":"تبریز جدید","yazd_abarkoh":"یزد-ابرکوه","yazd_ardakan":"یزد-اردکان","yazd_bafgh":"یزد-بافق","yazd_mehriz":"یزد-مهریز","yazd_meybod":"یزد-میبد","yazd_taft":"یزد-تفت","yazd_yazd":"یزد-یزد","shahrekord":"شهرکرد","bandarabas":"بندرعباس","khoramabad":"خرم آباد","ahvaz":"اهواز","kerman":"کرمان","kermanshah":"کرمانشاه","zanjan":"زنجان","orumie":"ارومیه","ghom":"قم","hamedan":"همدان"}}

مثال برای دریافت لیست استان ها :

http://smssama.ir/webservice/rest/sms_bank_list?bank_type=daemi

مثال برای دریافت لیست شهر های استان اصفهان :

http://smssama.ir/webservice/rest/sms_bank_list?bank_type=daemi&OstnCode=30

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

نام متد:

sms_bank_count

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_bank_count?

مثال :

http://smssama.ir/webservice/rest/sms_bank_count?bank_type=postal_code&postalcode_city=esfahan&postalcode=81556

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_bank_count?bank_type=postal_code&postalcode_city=esfahan&postalcode=81556 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است
number نشاندهنده تعداد شماره های موجود میباشد

{"result":true,"bank_type":"postal_code","number":"4888"}

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

نام متد:

sms_bank_send

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_bank_send?

مثال :

http://smssama.ir/webservice/rest/sms_bank_send?note=چجپ&bank_type=etebari&OstnCode=1&CityCode=102&record_start=3&receiver_count=1&sender_number=10007666

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_bank_send?note=چجپ&bank_type=etebari&OstnCode=1&CityCode=102&record_start=3&receiver_count=1&sender_number=10007666 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است
smsid شناسه ی پیامک های ارسال شده میباشد

{"result":true,"bank_type":"etebari","smsid":[9719137]}

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

نام متد:

lottery_org_new

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/lottery_org_new?

ارسال تمام موارد الزامی است

مثال :

http://smssama.ir/webservice/rest/lottery_org_new?price=10000&number=09135556666&factor_num=3030&sender_number=90009000&code=0

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/lottery_org_new?price=10000&number=09135556666&factor_num=3030&sender_number=90009000&code=0 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است
"msg":"به تعداد 3 کد قرعه کشی ایجاد شد "

{"result":true,"msg":"به تعداد 3 کد قرعه کشی ایجاد شد","counter":3}

از این متد برای ایجاد پترن استفاده می شود

نام متد:

sms_pattern_new

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_pattern_new?

مثال :

http://smssama.ir/webservice/rest/sms_pattern_new?note=سلام&login_username=USERNAME&login_password=PASSWORD&sender_number=90007666&has_pattren=1

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_pattern_new?login_username=USERNAME&login_password=PASSWORD&sender_number=90007666&has_pattren=1¬e='test(*)'& HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ :
مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true}

از این متد برای دریافت لیست پترن ها استفاده می شود.

نام متد:

sms_pattern_list

آدرس مورد استفاده :

http://smssama.ir/webservice/rest/sms_pattern_list?

مثال :

http://smssama.ir/webservice/rest/user_cat_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30

* Trying 194.9.80.19... * Connected to smssama.ir (194.9.80.19) port 80 (#0) > GET /webservice/rest/sms_pattern_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30 HTTP/1.1 Host: smssama.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

نمونه پاسخ : مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

{"result":true,"list":[{"id":"949","note":"تایید *","sender_number":"مسیر عمومی","date":"1730629807","date_fa":"1403\/8\/13 14:00"}],"count":1}

از این متد برای ارسال پیامک استفاده می شود.تمامی پارامتر ها به صورت GET برای آدرس ارسال میشود

نام متد:

send_sms

آدرس مورد استفاده :

http://smssama.ir/send_via_get/send_sms.php?

مثال :

http://smssama.ir/send_via_get/send_sms.php?note=سلام&username=USERNAME&password=PASSWORD&receiver_number=09132677411&sender_number=10007666

نمونه پاسخ : در این پاسخ 92943923 شناسه ی پیامک در سیستم ما میباشد که برای دلیوری به آن احتیاج دارید
مقدار result برابر true میباشد که نشاندهنده ی موفق بودن عملیات است

92943923

به تعداد گیرنده ها به شما شناسه ی پیامک داده خواهد شد که شناسه هابا علامت کاما , از هم جدا شده اند مانند :

92943981,92943982

از این متد برای ارسال پیامک استفاده می شود.تمامی پارامتر ها به صورت GET برای آدرس ارسال میشود

نام متد:

sms_deliver

آدرس مورد استفاده :

http://smssama.ir/send_via_get/send_sms.php?

مثال :

http://smssama.ir/send_via_get/send_sms.php?smsid[]=92943981&smsid[]=92943982&dargah=1000

نمونه پاسخ : در این پاسخ 92943981 شناسه ی پیامک در سیستم ما میباشد که 5 برای دلیوری آن داده شده است
عدد ۵ به معنای بلک لیست میباشد جدول وضعیت ها

Array ( [0] => 5 [1] => 1 )