وب سرویس سامانه پیام کوتاه

این راهنما جهت سهولت در کار برنامه نویسانی طراحی شده است که قصد دارند سرویس پیامهای خود را به نرم افزار های کاربردی خود ارتباط دهند.
این شرکت در حال حاضر وب سرویس ارسال پیام کوتاه و وب سرویس ارسال پیام صوتی ارئه میکند
روش های ارائه شده برای ارسال پیام کوتاه به شرح زیرمیباشد
1- وب سرویس REST
2- وب سرویس SOAP
3- ارسال از طریق URL
که از بین روش های ذکر شده این شرکت روش وب سرویس REST را پیشنهاد میدهد
روش های ارائه شده برای ارسال پیام صوتی به شرح زیرمیباشد
1- وب سرویس REST

برخی ارور ها

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

کد خطا	توضیح
error_login_user_not_found	چنین کاربری یافت نشد
error_login_not_like_username	نام کاربری مشکلی دارد مانند وجود فاصله
error_login_not_like_password	پسورد مشکلی دارد
error_login_not_like_accept	دسترسی شما مسدود شده است و یا کد تایید پیامکی را وارد نکرده اید
error_register_taken_email	چنین ایمیلی قبلا استفاده شده است
error_register_taken_user_username	نام کاربری قبلا اسفتاده شده است
error_register_taken_user_mobile	موبایل قبلا استفاده شده است
error_no_receiver	گیرنده های خالی میباشد
error_sender_number_is_not_allow	شماره ی ارسال کننده مجاز نمیباشد
error_long_request_uniqueid	طول کد یکتا بیشتر از جد مجاز است
error_sender_number_is_disable	شماره ی ارسال کننده غیرفعال میباشد
error_number_format_error	فرمت شماره ی گیرنده مشکل دارد
error_number_whois_error	شماره ی ارسال کننده اجراز هویت نشده است
error_sms_receiver_number_limit	تعداد گیرنده ها بیشتر از حد مجاز میباشد
error_sms_send_config_is_disable	ارسال از این پیش شماره موقتا غیر فعال میباشد
error_sms_price_not_found_for_admin	هزینه ی اراسال پیامک مدیر مشخص نمیباشد
error_sms_price_packageid_not_found_for_admin	پکیج قیمت مدیر یافت نشد
error_sms_price_not_found_for_user	هزینه ی اراسال پیامک برای کاربر مشخص نمیباشد
error_credit_admin_error	شارژ مدیر کم است
error_credit_admin_empty_error	هزینه ی ارسال برای مدیر اشتباه محاسبه شده است
error_credit_error	کمبود شارژ کاربر

درگاه ها

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

مقداری که باید استفاده شود	اپراتور مورد نظر
3000	3000
1000	1000
50002	50002
9821	ثابت
2000	2000
50001	50001
6758	6758
110	ویژه
10001	رهیاب دی
118	عمومی
8000	سیم کارت
2221	آسانک مسیر دوم
2222	ارمغان مسیر دوم
8002	مسیر دوم سیم کارت
30002	3000 مسیر دوم
100011	رهیاب دی - بالک
9000	9000
999800	آرینتل - خدماتی
999810	سامانتل مستقیم
999820	آرینتل تبلیغاتی نوع 2
90002	9000 - تبلیغاتی نوع دو
999801	تلیرکو - آرینتل - خدماتی
999811	jiring
999821	تلیرکو-آرینتل تبلیغاتی نوع 2
5000410	50004 - مسیر اصلی
5000420	50004 - مسیر اصلی - تبلغاتی نوع دو
9998210	آرینتل جدید

وضعیت پیامک ها

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

عدد	معنا
-1	پیام یافت نشد - ممکن است پیام به آرشیو منتقل شده باشد
0	بدون وضعیت - ممکن است پیام تازه ارسال شده باشد و در انتظار دریافت وضعیت باشد
1	رسیده به گوشی
2	نرسیده به گوشی
3	ارسال نشده به مخابرات
4	ارسال شده به مخابرات - ممکن است پیام ها پس از مدت زمانی برای ارسال به آرشیو به این وضعیت تبدیل شوند
5	لیست سیاه مخابرات - ممکن است به معنای بازگشت وجه نیز باشد
8	ارسال شده به اپراتور پیامکی
9	بازگشت هزینه به دلیل ترافیک مخابرات
10	صف ارسال
11	اسپم
12	اکسپایر
13	بدون روت
14	ریجکت شده
16	نرسیده به مخابرات
17	بدون وضعیت دلیوربیس

انتقال پیامک های دریافتی به آدرس

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

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

نام پارامتر	توضیح
from	شماره ی ارسال کننده ی پیامک مثلا 09132125459
to	شماره ی دریافت کننده ی پیامک مثلا 10007666
note	متن پیامک مثال این یک تست است
smsid	شناسه ی پیامک مثلا 1234567

فرمت تاریخ

تمامی تاریخ ها بر اساس 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

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

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

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

http://shahtootpayam.ir/webservice/soap/smsService.telir?wsdl
آدرس راهنما شامل نام متد ها و پارامتر های ورودی و مقادیر خروجی به شرح زیر میباشد :
http://shahtootpayam.ir/webservice/soap/smsService.php

پیام های دریافتی

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

نام متد:

sms_receive

پارامتر	نوع	توضیحات	مقادیر
username	String	نام کاربری مورد استفاده در سامانه پیامک
password	String	رمز عبور مورد استفاده در سامانه پیامک
number	String	شماره خط اختصاصی کاربر مورد استفاده در سامانه
catid	int	شناسه دسته بندی پیامک های دریافتی
start	int	شناسه شروع لیست پیامک ها	از 1 شروع میشود
perpage	int	تعداد پیامک های دریافتی در هر صفحه	30=پیش فرض
read	int	نوع خواندن	'-1'=مهم نیست '0' =خوانده نشده '1'=خوانده شده
order	string	نوع مرتب سازی	'ASC' = از اول به آخر 'DESC' = از آخر به اول

ارسال پیامک

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

نام متد:

send_sms

پارامتر	نوع	توضیحات	مقادیر
username	String	نام کاربری مورد استفاده در سامانه پیامک
password	String	رمز عبور مورد استفاده در سامانه پیامک
sender_number	ArrayOfString	شماره ارسال کننده در سامانه پیامک
receiver_number	ArrayOfString	شماره دریافت کننده پیامک
note	ArrayOfString	متن پیامک ارسالی
date	ArrayOfString	تاریخ ارسال پیامک ( ارسال در آینده ) - این متغیر به صورت آرایه ارسال میشود و میتواند شامل یک یا بیش از یک تاریخ باشد	0=هم اکنون ارسال شود
request_uniqueid	ArrayOfString	جهت جلوگیری از ارسال پیامک تکراری از منبع کد , میتوانید این متغیر را با یک عدد یا متن منحصر به فرد مقداردهی کنید . در صورت ارسال درخواست تکراری در پاسخ این متد smsid های قبلی ارسال خواهند شد	0=نیازی به چک کردن ندارد
flash	ArrayOfString	آیا پیامک به صورت فلش ارسال شود یا خیر	ok , no
onlysend	String	جهت ارسال سریع بدون وقفه در زمان ارسال پیامک ( ارسال پیامک با تاخیر 30 ثانیه به مشترک انجام خواهد شد)	ok , no ( ok == ارسال با تاخیر )

نمونه کد ارسال یک متن برای 2 گیرنده


                 <?xml version="1.0" encoding="UTF-8"?>
                 <SOAP-ENV:Envelope
                         xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
                         xmlns:ns1="sms_webservice_wsdl"
                         xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                         xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
                         xmlns:ns2="urn:sms_webservice_wsdl" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
                     <SOAP-ENV:Body>
                         <ns1:send_sms>
                             <username xsi:type="xsd:string">username here</username>
                             <password xsi:type="xsd:string">password here</password>
                             <sender_number SOAP-ENC:arrayType="xsd:string[1]" xsi:type="ns2:ArrayOfString">
                                 <item xsi:type="xsd:string">10007666</item>
                             </sender_number>
                             <receiver_number SOAP-ENC:arrayType="xsd:string[1]" xsi:type="ns2:ArrayOfString">
                                 <item xsi:type="xsd:string">+989126133361</item>
                             </receiver_number>
                             <note SOAP-ENC:arrayType="xsd:string[1]" xsi:type="ns2:ArrayOfString">
                                 <item xsi:type="xsd:string">تست</item>
                             </note>
                             <date SOAP-ENC:arrayType="xsd:string[1]" xsi:type="ns2:ArrayOfString">
                                 <item xsi:type="xsd:string">0</item>
                             </date>
                             <request_uniqueid SOAP-ENC:arrayType="xsd:string[1]" xsi:type="ns2:ArrayOfString">
                                 <item xsi:type="xsd:string"></item>
                             </request_uniqueid>
                             <flash SOAP-ENC:arrayType="xsd:string[1]" xsi:type="ns2:ArrayOfString">
                                 <item xsi:type="xsd:string">no</item>
                             </flash>
                             <onlysend xsi:type="xsd:string">ok</onlysend>
                         </ns1:send_sms>
                     </SOAP-ENV:Body>
                 </SOAP-ENV:Envelope>

مفاهیم کلی ارسال پیامک از طریق REST

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

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

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

نمونه کد ارسال با استفاده از متد POST و استفاده از APIKEY

                       curl --location -k --request POST 'http://shahtootpayam.ir/webservice/rest/sms_send' \

                       --header 'Content-Type: application/x-www-form-urlencoded' \

                       --data-urlencode 'api_key=2:628fa6a500d3b' \

                       --data-urlencode 'receiver_number=09132125459' \

                       --data-urlencode 'sender_number=10007666' \

                       --data-urlencode 'note_arr[]=hi' \

                       --data-urlencode 'date=0' \

                       --data-urlencode 'request_uniqueid=0' \

                       --data-urlencode 'flash=no' \

                       --data-urlencode 'onlysend=no' \

                       --data-urlencode 'show_faktor=no'

نمونه کد نظیر به نظیر با استفاده از متد POST و استفاده از APIKEY

                       curl --location -k --request POST 'http://shahtootpayam.ir/webservice/rest/sms_send' \

                       --header 'Content-Type: application/x-www-form-urlencoded' \

                       --data-urlencode 'api_key=2:628fa6a500d3b' \

                       --data-urlencode 'sender_number=10007666' \

                       --data-urlencode 'note_arr[]=hi' \

                       --data-urlencode 'receiver_number[]=091321254591' \

                       --data-urlencode 'note_arr[]=hi1' \

                       --data-urlencode 'receiver_number[]=091321254592' \

                       --data-urlencode 'note_arr[]=hi2' \

                       --data-urlencode 'receiver_number[]=091321254593' \

                       --data-urlencode 'note_arr[]=hi3' \

                       --data-urlencode 'date=0' \

                       --data-urlencode 'request_uniqueid=0' \

                       --data-urlencode 'flash=no' \

                       --data-urlencode 'onlysend=no' \

                       --data-urlencode 'show_faktor=no'

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

                       {"result":true,"list":["2_63295d1d86c63_0","2_63295d1d86c63_1","2_63295d1d86c63_2"]}

نمونه کد ارسال با استفاده از متد POST و استفاده از هدر توکن

                       curl --location -k --request POST 'http://shahtootpayam.ir/webservice/rest/sms_send' \

                       --header 'Content-Type: application/x-www-form-urlencoded' \

                       --header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpZCI6IjExIiwiZHQiOjE2OTcwMzAwMTUsImV4cCI6MTY5NzAzMTIxNSwiaSI6IjEiLCJwIjoiZWU2NGY0NmVhY2E3Y2E4YTIyZDgzZWZkZDY4NDM5ZjQiLCJpcCI6IjEyNy4wLjAuMSJ9.gn4FSUvIZdgguEVQLZerLdzNGySqTYas2OBN7bVoPj2S6PxJvA-OpjkndCSWdAy3tjvhOWPY_EeQRe5rAmYkQvCcC39y9msB7ZngcFq5gcJLPZeragVQAoT0PL9XiX-XHwk69GpaYeuAK6QYun6YSwk6ke91OKJw3BU1wB809bnhVeSBYPIQQ0MwMeWtPTOCM-OjBUI2T3G7erUWDIcuGM-gQbFQ9bqpjpvOIk3wqgvbUuZGPapt7YBoIxK5pWmK3Ajz9wFukhj8Np4ICaNGO9kMNqZ5Mxk5Bg3fn0_amAQOMZAUIeDqBmFq8tYoERaQZR-NoKHwVw4OKb60qfVkGQ

                       --data-urlencode 'api_key=2:628fa6a500d3b' \

                       --data-urlencode 'receiver_number=09132125459' \

                       --data-urlencode 'sender_number=10007666' \

                       --data-urlencode 'note_arr[]=hi' \

                       --data-urlencode 'date=0' \

                       --data-urlencode 'request_uniqueid=0' \

                       --data-urlencode 'flash=no' \

                       --data-urlencode 'onlysend=no' \

                       --data-urlencode 'show_faktor=no'

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

http://shahtootpayam.ir/webservice/rest/

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

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

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

مثال :

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

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

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

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

دریافت توکن احراز هویت

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

نام متد:

getLoginAccessToken

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

http://shahtootpayam.ir/webservice/rest/getLoginAccessToken?

پارامتر	نوع	توضیحات
token_username	String	نام کاربری مورد استفاده در سامانه پیامک
token_password	String	رمز عبور مورد استفاده در سامانه پیامک
grant_type	String	مقدار password

هدر Authorization از نوع Basic باید مطابق با userid:username با base64 کدگزاری و همراه با درخواست ارسال گردد

مثال :

http://shahtootpayam.ir/webservice/rest/getLoginAccessToken?token_username=USERNAME&token_password=PASSWORD&grant_type=password

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/getLoginAccessToken?token_username=USERNAME&token_password=PASSWORD HTTP/1.1 > Authorization: Basic dGVzdDox Host: shahtootpayam.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

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

{ "result": true, "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpZCI6IjEiLCJkdCI6MTY5Njc5MDY0MCwiZXhwIjoxNjk2ODYyNjQwLCJpIjoiMSIsInAiOiJlZTY0ZjQ2ZWFjYTdjYThhMjJkODNlZmRkNjg0MzlmNCIsImlwIjoiMTI3LjAuMC4xIn0.VDCtQXcZsjkOdjoVFKZzNna_Nx5BoW62Oag5j8TUZYbuAJmatZ7O4DS1B4LAAKyjs2_VjizT-kvmCw0zWN-UCzc0ryHvPQoUVNM6P3ZonrgLX4LCFyK17qdIYrF2XxfRuB94drHnFwPUd1C5qBgNs0lWHRozGepW82nIqvIXtErXSdGVP5yY8bmeFYjC6zTJk3TZwS4X2AXbYjaoP_4nDaalxsE6Myti4d20l0-MjIPiZdZFM8mkldXITi-xGzad_q6doyzZMeHERigWxyGem09TVPO8u7P_2BTCVlvJG2LQcf8jnKgsZjhgSxONJXdejrZaUMZP2OvzpQbmFz2aDw", "refresh_token": "8d9f265a-c3e6-0ddc-bc99-27ab9313c6be", "expires_in": 65773, "token_type": "bearer" }

token_type: نوع توکن دریافتی
expires_in: زمان اعتبار توکن (میلی ثانیه)
token: با استفاده از این توکن می‌توانید دیگر سرویس ها را فراخوانی کنید
refresh_token: با استفاده از این توکن می‌توانید توکن را با استفاده از متد رفرش توکن تمدید نمایید

مقدار token برای احراز هویت در کلیه متد ها در هدر Authorization و شروع با مقدار bearer به مدت زمان expires_in میتواند استفاده شود

تازه سازی توکن احراز هویت

از این متد برای دریافت توکن جدید با استفاده از مقدار refresh_token استفاده می شود.
از آنجاییکه عمر توکن ها محدود است و مقدار آن در فیلد expires_in همراه توکن ارسال شده است،‌ باید قبل از منقضی شدن توکن با ارسال رفرش توکن، توکن جدید را دریافت کنید

نام متد:

RefreshLoginToken

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

http://shahtootpayam.ir/webservice/rest/RefreshLoginToken?

پارامتر	نوع	توضیحات	مقادیر
refresh_token	String	مقدار کلید refresh_token از خروجی متد getLoginAccessToken
grant_type	String	مقدار refresh_token

هدر Authorization از نوع Basic باید مطابق با userid:username با base64 کدگزاری و همراه با درخواست ارسال گردد

مثال :

http://shahtootpayam.ir/webservice/rest/RefreshLoginToken?refresh_token=4af90465-7c30-879b-ae73-6c9e404c85ae&grant_type=refresh_token

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/RefreshLoginToken?refresh_token=4af90465-7c30-879b-ae73-6c9e404c85ae&grant_type=refresh_token HTTP/1.1 > Authorization: Basic dGVzdDox Host: shahtootpayam.ir * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Server: Apache/2 < Connection: close

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

مقدار token برای احراز هویت در کلیه متد ها در هدر Authorization و شروع با مقدار bearer به مدت زمان in_expires میتواند استفاده شود

دریافت اطلاعات کاربری

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

نام متد:

user_info

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

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

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/user_info?login_username=USERNAME&login_password=PASSWORD HTTP/1.1 Host: shahtootpayam.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":"09132125459","cash":"3212509","date":"1389\/5\/5 00:46","date_expire":"1394\/2\/24 00:00"},"number":{"result":true,"list_user":[{"number":"10007666","order":"shop_serial,label_reply,tahlilgar,bime,mobile_control"},{"number":"10007666","order":""}]}}

ارسال پیامک

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

نام متد:

sms_send

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

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

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
receiver_number	String	شماره دریافت کننده پیامک که شماره ها باعلامت کاما , از هم جدا شده باشند
receiver_number	ArrayOfString	شماره دریافت کننده پیامک که میتوانید به صورت آرایه ارسال نمایید
clientids	ArrayOfString	شناسه پیامک برای دریافت دلیوری که میتوانید به صورت آرایه ارسال نمایید
sender_number	String	شماره ارسال کننده در سامانه پیامک
note_arr	String	متن پیامک ارسالی میتواند به صورت استرینگ ارسال شود
note_arr	ArrayOfString	متن پیامک ارسالی میتواند به صورت آرایه ارسال شود
date	String	تاریخ ارسال پیامک ( ارسال در آینده )	0=هم اکنون ارسال شود
request_uniqueid	String	جهت جلوگیری از ارسال پیامک تکراری از منبع کد , میتوانید این متغیر را با یک عدد یا متن منحصر به فرد مقداردهی کنید . در صورت ارسال درخواست تکراری در پاسخ این متد smsid های قبلی ارسال خواهند شد	0=نیازی به چک کردن ندارد
flash	String	آیا پیامک به صورت فلش ارسال شود یا خیر	ok , no
onlysend	String	جهت ارسال سریع بدون وقفه در زمان ارسال پیامک ( ارسال پیامک با تاخیر 30 ثانیه به مشترک انجام خواهد شد)	ok , no ( ok == ارسال با تاخیر )
show_faktor	String	عدم ارسال و فقط نمایش میزان هزینه	ok , no
tb_name_in_smsid	String	در صورت ارسال این پارامتر شناسه پیامک های شما حاوی اطلاعات بیشتری است و برای دریافت دلیوری باید از متد sms_deliver_tb_name_in_smsid استفاده نمایید	ok

مثال :

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

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

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

{"result":true,"list":['788137_5fcc745d14604_0']}

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

{"result":true,"list":['788137_5fcc745d14604_0','788137_5fcc745d14604_1']}

مثال با api_key :

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

اتصال وب سرویس به سیستم حسابداری هلو

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

درگاه : shahtootpayam.ir

لینک ارسال :

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

وضعیت پیامک

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

نام متد:

sms_deliver

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

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

پارامتر	نوع	توضیحات	مقادیر
dargah	String	علامت درگاه ها که قبلا توضیح داده شده است توضیح بیشتر	مانند 1000
smsid	ArrayOfString	شناسه های پیامک های ارسالی که میتوانید به صورت آرایه ارسال نمایید
archive_year	Int	برای جستجو در آرشیو سال ارسال پیامک مانند 1400 ارسال گردد
archive_month	Int	برای جستجو در آرشیو ماه ارسال پیامک مانند 3 ارسال گردد

مثال :

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

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

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

در صورتی که در جدول جاری جستجو میکردید و عدد -1 را به عنوان دلیوری دریافت کردید باید در آرشیو جستجو نمایید

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

وضعیت پیامک

نام متد:

sms_deliver_tb_name_in_smsid

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

http://shahtootpayam.ir/webservice/rest/sms_deliver_tb_name_in_smsid?

پارامتر	نوع	توضیحات	مقادیر
smsid	ArrayOfString	شناسه های پیامک های ارسالی که میتوانید به صورت آرایه ارسال نمایید

مثال :

http://shahtootpayam.ir/webservice/rest/sms_rest_sms_deliver_tb_name_in_smsid?smsid[]=92943981&smsid[]=92943982

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

در صورتی که در جدول جاری جستجو میکردید و عدد -1 را به عنوان دلیوری دریافت کردید باید در آرشیو جستجو نمایید

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


                 curl --location -k --request POST 'http://crmsms.ariantel.ir/webservice/rest/sms_deliver_tb_name_in_smsid' \
                 --header 'Content-Type: application/x-www-form-urlencoded' \
                 --data-urlencode 'smsid[]=999810@1401@10@27_293675_0@+989355090501' \
                 --data-urlencode 'smsid[]=999810@1401@10@27_293675_0@+989355090502' \
                 --data-urlencode 'smsid[]=999810@1401@10@27_293675_0@+989355090503'

ایجاد گروه جدید در دفترتلفن

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

نام متد:

user_cat_add

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

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

پارامتر	نوع	توضیحات
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
title	String	عنوان گروه

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/user_cat_add?login_username=USERNAME&login_password=PASSWORD&title=دوستان HTTP/1.1 Host: shahtootpayam.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://shahtootpayam.ir/webservice/rest/user_cat_list?

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
page_number	Int	شماره ی صفحه	از 1 شروع میشود
perpage	Int	تعداد نمایش در نتایج

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/user_cat_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30 HTTP/1.1 Host: shahtootpayam.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://shahtootpayam.ir/webservice/rest/user_cat_info?

پارامتر	نوع	توضیحات
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
id	Int	شناسه ی گروه

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/user_cat_info?login_username=USERNAME&login_password=PASSWORD&id=156487 HTTP/1.1 Host: shahtootpayam.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://shahtootpayam.ir/webservice/rest/sms_number_add?

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
catid	Int	شناسه ی گروه
number	String	شماره موبایل
fullname	String	اسم و فامیل
repeat	String	چک شدند برای جلوگیری از ثبت تکراری 1- در صورتی ثبت شود که فقط در همین بخش این شماره قبلا ثبت نشده باشد 2- در صورتی ثبت شود که این شماره قبلا در هیچ بخشی ثبت نشده باشد 3- در همه ی شرایط ثبت شود	1,2,3
gender	String	جنسیت	1=مرد 2-زن
fullname_en	String	اسم و فامیل لاتین
gender_en	String	جنسیت برای لاتین	1=مرد 2-زن
blacklist_no_check	String	چک شود درصورتی که در بلک لیست بود اضافه نشود در صورتی که مقدار "true" ارسال شود چک نمیشود پیش فرض false میباشد	true,false

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/sms_number_add?login_username=USERNAME&login_password=PASSWORD&catid=156487&repeat=3&number=09132125459&fullname=تست&gender=1&fullname_en=test&gender_en=1&blacklist_no_check=true HTTP/1.1 Host: shahtootpayam.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":" شماره ی xxxxx قبلا در بخش های دیگر ثبت شده است"}
{"result":false,"error":"بخش انتخاب شده مربوط به شما نمیباشد."}

دریافت شماره های دفترتلفن

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

نام متد:

sms_number_list

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

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

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
page_number	Int	شماره ی صفحه	از 1 شروع میشود
perpage	Int	تعداد نمایش در نتایج
catid	Int	شماره ی بخش دفتر تلفن	برای فیلتر کردن نتایح
fullname	String	اسم و فامیل فارسی	برای فیلتر کردن نتایح
number	Int	شماره تلفن	برای فیلتر کردن نتایح

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/sms_number_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30 HTTP/1.1 Host: shahtootpayam.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://shahtootpayam.ir/webservice/rest/sms_number_update?

پارامتر	نوع	توضیحات	مقادیر
catid	Int	شماره ی بخش دفتر تلفن

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/sms_number_update?catid=30 HTTP/1.1 Host: shahtootpayam.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://shahtootpayam.ir/webservice/rest/sms_receive_list?

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
page_number	Int	شماره ی صفحه	از 1 شروع میشود
perpage	Int	تعداد نمایش در نتایج
catid	Int	شماره گروه پیامکهای دریافتی	در صورتی که نیاز به فیلتر کردن بر اساس این پارامتر ندارید پارامتر را ارسال ننمایید
read	Int	نوع خوانده شدن پیامک	1=خوانده شده ها 0=خوانده نشده ها در صورتی که خالی ارسال شود تمامی پیام ها را میدهد
number	Int	شماره دریافت کننده ی پیام	درصورتی که بیشتر از 1 خط اختصاصی دارید ارسال نمایید. در غیر این صورت نیاز به ارسال این پارامتر نمیباشد در صورت عدم ارسال این پارامتر پیام های دریافتی کلیه خطوط اختصاصی کاربر شما در نتایج ظاهر خواهند شد
labelid	Int	شناسه ی کلمه ی کلیدی	در صورتی که نیاز به فیلتر کردن بر اساس این پارامتر ندارید پارامتر را ارسال ننمایید
count	Int	فقط تعداد را نمایش بده	در صورت قرار دادن این پارامتر تعداد نتایج در count به شما نمایش داده خواهد شد در صورتی که لیست پیام های دریافتی را نیاز دارید این پارامتر را ارسال ننمایید
fromid	Int	نمایش نتایج بزرگتر از این شناسه	در صورت قرار دادن این پارامتر پیامهای دارای id بزرگتر از این عدد به شما نمایش داده خواهد شد

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/sms_receive_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30 HTTP/1.1 Host: shahtootpayam.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":"09132125459","receiver_number":"10007666","date":"1493483544","date_fa":"1396\/2\/9 21:02","catid":"0","read":"0","note":"خانم شیرانی"},{"id":"1227938","sender_number":"09300706012","receiver_number":"10007666","date":"1493481719","date_fa":"1396\/2\/9 20:31","catid":"0","read":"0","note":"داداشی اینقد بچه کوچیک اونجا بود مشکل کند ذهنی و عقب افتادگی داشتن اصن ..."}]}

تغییر وضعیت خواندن پیام های دریافتی

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

نام متد:

sms_receive_change_read

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

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

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
id	ArrayOfString	شناسه ی پیامک ها به صورت آرایه
read	Int	وضعیت جدید	1=خوانده شده 0=خوانده نشده

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/sms_receive_change_read?login_username=USERNAME&login_password=PASSWORD&read=1&id[]=156487 HTTP/1.1 Host: shahtootpayam.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://shahtootpayam.ir/webservice/rest/label_list?

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
page_number	Int	شماره ی صفحه	از 1 شروع میشود
perpage	Int	تعداد نمایش در نتایج
state	Int	وضعیت	0,1
kind	Int	نوع کلمه ی کلیدی	پس از مثال جدول اعداد و مفاهیم قرار داده شده است
refferid	Int	شناسه ی رکورد مرتبط	مثلا شناسه ی نظرسنجی اصلی ایجاد شده
number	String	شماره ی دریافت کننده

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/label_list?login_username=USERNAME&login_password=PASSWORD&page_number=1&perpage=30 HTTP/1.1 Host: shahtootpayam.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":"10007666","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 موجود در پاسخ در جدول زیر آمده است

علامت اختصاص یافته	مفهوم
1	منشی پیامک
2	نظرسنجی
3	مسابقه
4	پیشنهاد

ایجاد کلمات کلیدی

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

نام متد:

label_new

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

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

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
title	String	عنوان در نظر گرفته شده برای این کلمه ی کلیدی	از
label	String	کلمه کلیدی مورد نظر
note	String	متن پاسخ	0,1
repeat	Int	تعداد دریافت پاسخ از یک شماره	0=فقط ۱ پاسخ از کاربر دریافت شود
kind	Int	نوع کلمه ی کلیدی	پس از مثال جدول اعداد و مفاهیم قرار داده شده است
refferid	Int	شناسه ی رکورد مرتبط	مثلا شناسه ی نظرسنجی اصلی ایجاد شده
number	String	شماره ی دریافت کننده
time_limit	Int	محدودیت زمانی	0=بدون محدودیت زمانی 1=در بازه زمانی مشخص شده فعال باشد
date_start	BigInt	شروع محدودیت زمانی بر اساس unix timestamp
date_end	BigInt	پایان محدودیت زمانی بر اساس unix timestamp
catid	Int	شماره رکورد گروه دفترتلفن برای ذخیره ی شماره در دفترچه تلفن
catid_delete	Int	شماره رکورد گروه دفترتلفن برای حذف شماره از دفترچه تلفن
reply	Int	ارسال متن پس از دریافت پیامک	0=خیر (پیش فرض) 1=بلی

مثال :

http://shahtootpayam.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.156... * Connected to shahtootpayam.ir (194.9.80.156) 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: shahtootpayam.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://shahtootpayam.ir/webservice/rest/label_edit?

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
id	Int	شناسه ی کلمه ی کلیدی ای که میخواهید آن را ویرایش کنید
title	String	عنوان در نظر گرفته شده برای این کلمه ی کلیدی
label	String	کلمه کلیدی مورد نظر
note	String	متن پاسخ	0,1
repeat	Int	تعداد دریافت پاسخ از یک شماره	0=فقط ۱ پاسخ از کاربر دریافت شود
number	String	شماره ی دریافت کننده
time_limit	Int	محدودیت زمانی	0=بدون محدودیت زمانی 1=در بازه زمانی مشخص شده فعال باشد
date_start	BigInt	شروع محدودیت زمانی بر اساس unix timestamp
date_end	BigInt	پایان محدودیت زمانی بر اساس unix timestamp
catid	Int	شماره رکورد گروه دفترتلفن برای ذخیره ی شماره در دفترچه تلفن
catid_delete	Int	شماره رکورد گروه دفترتلفن برای حذف شماره از دفترچه تلفن
reply	Int	ارسال متن پس از دریافت پیامک	0=خیر (پیش فرض) 1=بلی

مثال :

http://shahtootpayam.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.156... * Connected to shahtootpayam.ir (194.9.80.156) 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: shahtootpayam.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://shahtootpayam.ir/webservice/rest/label_remove?

پارامتر	نوع	توضیحات
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
id	Int	شناسه ی کلمه ی کلیدی

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/label_remove?login_username=USERNAME&login_password=PASSWORD&id=156487 HTTP/1.1 Host: shahtootpayam.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://shahtootpayam.ir/webservice/rest/user_once_login?

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
expire	Int	تعداد روز معتبر بودن لینک	مقدار پیش فرض 1 میباشد بدین معنا که لینک تولید شده فقط تا ۲۴ ساعت بعد امکان استفاده دارد

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/user_once_login?login_username=USERNAME&login_password=PASSWORD&expire=2 HTTP/1.1 Host: shahtootpayam.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.telir?id=2&md5=XXXXXXX&token=XXXXXXXXXXXXXXXXX"}

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

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

نام متد:

sms_bank_list

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

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

پارامتر	نوع	توضیحات	مقادیر
bank_type	String	نوع بانک درخواستی	postal_code = برای اسامی کدپستی همراه اول etebari = شماره های اعتباری همراه اول daemi = شماره های دایمی همراه اول
OstnCode	Int	شماره رکورد استان برای دریافت لیست شهر های یک استان	در صورتی که bank_type=etebari یا bank_type=daemi باشد

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/sms_bank_list?bank_type=postal_code HTTP/1.1 Host: shahtootpayam.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://shahtootpayam.ir/webservice/rest/sms_bank_list?bank_type=daemi

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

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

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

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

نام متد:

sms_bank_count

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

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

پارامتر	نوع	توضیحات	مقادیر
bank_type	String	نوع بانک درخواستی	postal_code = برای اسامی کدپستی
postalcode_city	String	اسم لاتین شهر درخواستی	در صورتی که bank_type=postal_code باشد
postalcode	Int	کدپستی مورد نظر	در صورتی که bank_type=postal_code باشد

مثال :

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

* Trying 194.9.80.156... * Connected to shahtootpayam.ir (194.9.80.156) port 80 (#0) > GET /webservice/rest/sms_bank_count?bank_type=postal_code&postalcode_city=esfahan&postalcode=81556 HTTP/1.1 Host: shahtootpayam.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://shahtootpayam.ir/webservice/rest/sms_bank_send?

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
bank_type	String	نوع بانک درخواستی	postal_code = برای اسامی کدپستی همراه اول etebari = شماره های اعتباری همراه اول daemi = شماره های دایمی همراه اول
postalcode_city	String	اسم لاتین شهر درخواستی	در صورتی که bank_type=postal_code باشد
postalcode	Int	کدپستی مورد نظر	در صورتی که bank_type=postal_code باشد
OstnCode	Int	شماره رکورد استان	در صورتی که bank_type=etebari یا bank_type=daemi باشد
CityCode	Int	شماره رکورد شهر	در صورتی که bank_type=etebari یا bank_type=daemi باشد
record_start	Int	شروع تعداد از این رکورد
receiver_count	Int	تعداد کل گیرنده ها
sender_number	Int	شماره ی ارسال کننده
note	String	متن پیامک

مثال :

http://shahtootpayam.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.156... * Connected to shahtootpayam.ir (194.9.80.156) 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: shahtootpayam.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]}

ارسال پیامک

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

نام متد:

send_sms

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

http://shahtootpayam.ir/send_via_get/send_sms.telir?

پارامتر	نوع	توضیحات	مقادیر
username	String	نام کاربری مورد استفاده در سامانه پیامک
password	String	رمز عبور مورد استفاده در سامانه پیامک
receiver_number	String	شماره دریافت کننده پیامک که شماره ها باعلامت کاما , از هم جدا شده باشند
sender_number	String	شماره ارسال کننده در سامانه پیامک
note	String	متن پیامک ارسالی میتواند به صورت استرینگ ارسال شود
request_uniqueid	String	جهت جلوگیری از ارسال پیامک تکراری از منبع کد , میتوانید این متغیر را با یک عدد یا متن منحصر به فرد مقداردهی کنید . در صورت ارسال درخواست تکراری در پاسخ این متد smsid های قبلی ارسال خواهند شد	0=نیازی به چک کردن ندارد
ersal_flash	String	آیا پیامک به صورت فلش ارسال شود یا خیر	ok , no
onlysend	String	جهت ارسال سریع بدون وقفه در زمان ارسال پیامک ( ارسال پیامک با تاخیر 30 ثانیه به مشترک انجام خواهد شد)	ok , no

مثال :

http://shahtootpayam.ir/send_via_get/send_sms.telir?note=سلام&username=USERNAME&password=PASSWORD&receiver_number=09132125459&sender_number=10007666

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

92943923

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

92943981,92943982

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

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

نام متد:

sms_deliver

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

http://shahtootpayam.ir/send_via_get/send_sms.telir?

پارامتر	نوع	توضیحات	مقادیر
dargah	String	علامت درگاه ها که قبلا توضیح داده شده است توضیح بیشتر	مانند 1000
smsid	ArrayOfString	شناسه های پیامک های ارسالی که میتوانید به صورت آرایه ارسال نمایید

مثال :

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

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

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

در تمامی نمونه کد های قرار گرفته اطلاعات زیر به صورت پیش فرض قرار گرفته که برای استفاده باید آنها را تغییر دهید :

دامین سرویس دهنده : sms321.ir ( این دامین را با دامین سایتی که پنل ارسال پیامک را از آن تهیه کرده اید در کد ها جایگزین کنید )

نام کاربری : USERNAME

رمز عبور : PASSWORD

شماره ی ارسال کننده : 10007666

شماره ی دریافت کننده : 09132125459

متن ارسال : سلام

وب سرویس به زبان PHP

جهت دریافت از لینک زیر استفاده کنید :

دانلود نمونه کد REST دانلود نمونه کد SOAP

کامند لاین لینوکس

جهت دریافت از لینک زیر استفاده کنید :

دانلود نمونه کد REST

آندروید

جهت دریافت از لینک زیر استفاده کنید :

دانلود نمونه کد REST

وب سرویس به زبان C#

جهت دریافت از لینک زیر استفاده کنید :

دانلود نمونه کد REST

وب سرویس به زبان Asp.net

جهت دریافت از لینک زیر استفاده کنید :

دانلود نمونه کد REST

وب سرویس به زبان دلفی

جهت دریافت از لینک زیر استفاده کنید :

دانلود نمونه کد REST

وب سرویس به زبان جاوا

جهت دریافت از لینک زیر استفاده کنید :

دانلود نمونه کد REST

ارسال پیامک از اکسس

جهت دریافت از لینک زیر استفاده کنید :

دانلود نمونه کد URL

ارسال پیامک از پایتون

جهت دریافت از لینک زیر استفاده کنید :

دانلود نمونه کد REST

ارسال پیامک در postman

جهت دریافت از لینک زیر استفاده کنید :

دانلود نمونه کد REST

دانلود فیلم آموزشی

ارسال پیام صوتی

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

نام متد:

send

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

http://shahtootpayam.ir/webservice/vms/api.php

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
api	String	برای ارسال پیام صوتی مقدار send را وارد نمایید	send
receiver_number	String	شماره دریافت کننده پیامک که شماره ها باعلامت کاما , از هم جدا شده باشند
uniqid	String	جهت جلوگیری از ارسال پیام تکراری از منبع کد , میتوانید این متغیر را با یک عدد یا متن منحصر به فرد مقداردهی کنید . در صورت ارسال درخواست تکراری در پاسخ این متد smsid های قبلی ارسال خواهند شد	0=نیازی به چک کردن ندارد
kind	String	کانال ارسال پیام صوتی در حال حاضر مقدار yek مورد قبول است	yek
billing_note	String	توضیحات برای درج در امور مالی
fileToUpload	File	فايل ارسالي انكود شده بصورت multipart/form-data

نمونه کد PHP :

<? $file_name_with_full_path = realpath('test.wav'); //مسیر فایل صوتی $post = array('login_username' => 'payamak21',//نام کاربری 'login_password' => 'password',//رمز عبور 'api' => 'send',//متد ارسال پیام 'uniqid' => '', 'kind' => 'yek',//کانال ارسال 'receiver_number' => '09132125459,03132382731', //شماره ها را با کاما میتوانید جدا کنید 'billing_note' => 'test',//توضیحات برای خودتان 'fileToUpload'=> curl_file_create($file_name_with_full_path)); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL,'http://shahtootpayam.ir/webservice/vms/api.php'); curl_setopt($ch, CURLOPT_POSTFIELDS, $post); curl_setopt($ch, CURLOPT_RETURNTRANSFER,1); $result=curl_exec ($ch); curl_close ($ch); print_r( json_decode( $result )); ?>

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

{"result":true,"list":"4"}

احراز هویت صوتی

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

نام متد:

otp

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

http://shahtootpayam.ir/webservice/vms/api.php

پارامتر	نوع	توضیحات	مقادیر
login_username	String	نام کاربری مورد استفاده در سامانه پیامک
login_password	String	رمز عبور مورد استفاده در سامانه پیامک
api	String	برای احراز هویت صوتی مقدار otp را وارد نمایید	otp
receiver_number	String	شماره دریافت کننده
clientid	String	جهت جلوگیری از ارسال پیام تکراری از منبع کد , میتوانید این متغیر را با یک عدد یا متن منحصر به فرد مقداردهی کنید . در صورت ارسال درخواست تکراری در پاسخ این متد smsid های قبلی ارسال خواهند شد	0=نیازی به چک کردن ندارد
kind	String	کانال ارسال پیام صوتی در حال حاضر مقدار yek مورد قبول است	yek
billing_note	String	توضیحات برای درج در امور مالی
otp_code	Int	کدی که برای کاربر به صورت صوتی پخش میشود

نمونه کد PHP :

<? $post = array('login_username' => 'payamak21',//نام کاربری 'login_password' => 'password',//رمز عبور 'api' => 'otp',//متد ارسال احراز هویت صوتی 'clientid' => '', 'kind' => 'yek',//کانال ارسال 'receiver_number' => '09132125459', //شماره ها 'billing_note' => 'test',//توضیحات برای خودتان 'otp_code'=> 123456); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL,'http://shahtootpayam.ir/webservice/vms/api.php'); curl_setopt($ch, CURLOPT_POSTFIELDS, $post); curl_setopt($ch, CURLOPT_RETURNTRANSFER,1); $result=curl_exec ($ch); curl_close ($ch); print_r( json_decode( $result )); ?>

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

{"result":true,"list":"4"}