سرویس های 2G دولت همراه | توضیحات استفاده از گره وب سرویس

باسلام

برای استفاده از این گره باید آدرس یک فایل را در بستر اینترنت تهیه نمایید مانند :

http://domain.com/ussd/test.php

سپس باید متغیرهای مورد نیازتان در ادامه ی آدرس تعریف نمایید و علامت های تعریف شده ی سیستم را به آنها نسبت دهید مانند :

علامت تعریف شده ی $phone$ موبایل مشتری را نشان میدهد و شما علامت  mobile  را برای خودتان تعریف مینمایید . آدرس شما به شکل زیر خواهید شد 

http://domain.com/ussd/test.php?mobile=$phone$

در صورتی که از زبان php  استفاده مینمایید در سایت خود با دستور  $_GET['mobile']  میتوانید مقدار وارد شده برای تلفن را دریافت نمایید

همچنین میتوانید از متد POST استفاده نمایید فقط کافیست مقادیری که میخواهید به صورت POST ارسال شوند را در جای مشخص شده قرار دهید
به طور مثال
mgov=ok&age=30
 

همچنین میتوانید هدر های مورد نیاز خود را نیز در قسمت مشخص شده قرار دهید .برای مثال شما میخواهید داده هایی با فرمت xml و یا json ارسال نمایید برای این موضوع باید هدر مناسب را در این قسمت قرار دهید

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

برای راحتی کاربران ورودی این قسمت با فرمت json دریافت میشود تا بتوانید چندین هدر نیز به صورت همزمان ارسال نمایید

برخی از هدرهای معروف به صورت زیر است :

["Content-Type: text/html;set=utf-8" , "Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==" ,"Content-Type: application/json" , "Content-Type: text/xml" ]

 

نوع پاسخ متن ساده ( plain text ) هر آنچه خروجی وب سرویس شما باشد به کاربر نمایش داده میشود

در صورتی که نیاز دارید از طریق وب سرویس کاربر را به گره ی دیگری منتقل نمایید در خروجی ابتدا باید عبارت goto:   را بنویسید سپس شناسه ی گره ای که میخواهید کاربر به آن منتقل شود را بنویسید به طور مثال goto:5  برای رفتن به گره ای که شناسه ی آن 5 میباشد
 
 
نوع پاسخ Json خروجی ای که وب سرویس شما میدهد تبدیل به متغیر هایی میشود که در گره های بعدی میتوانید از آن ها استفاده نمایید
به طور مثال خروجی شما
{"username":"myusername","password":"mypassword"}  
پیشوند وب سرویس شما res میباشد برای شما ۲ متغیر res_username و res_password ایجاد میشود که میتوانید از آنها استفاده نمایید برای مثال در متن میتوانید از $res_username$ استفاده نمایید
 
نوع پاسخ Xml خروجی ای که وب سرویس شما میدهد تبدیل به متغیر هایی میشود که در گره های بعدی میتوانید از آن ها استفاده نمایید
به طور مثال خروجی شما به شکل زیر میباشد
<para username="xx"><pass>hello world</pass></para>
 
 

خروجی شما تبدیل به متغیر هایی میشود که به شکل زیر میباشد :

@attributes_cash => 1200
para_@attributes_username => xx
para_pass => hello world

متغیر ها را میتوانید در متن خود استفاده نمایید به طور مثال $para_pass$
 

 
در صورتی در پاسخی که از وب سرویس شما داده میشود هدر خاصی وجود دارد که شما نیازمند استفاده از آن هدرها در گره های بعدی هستید در قسمت مشخص شده این هدر ها را به فرمت Json بنویسید
به طور مثال شما نیازمند هدری با نام  Location  هستید در قسمت  مشخص شده عبارت زیر را باید بنویسید :
["Location"]
نمونه هدر ارسالی توسط وب سرویس شما برای این مثال :
Location: http://www.example.com/
در صورتی که نوع خروجی شما متن ساده است میتوانید از این موارد نیز استفاده نمایید :
1-انتقال به شماره ی خارج از پنل اصلی سایت
برای اینکار باید در خروجی خود به این صورت عمل نمایید :
goto:*724*3*1*0#
2-انتقال به شماره ی داخل پنل سایت :
به جای ستاره اول شماره از علامت @@ استفاده نمایید
goto:@@6655*3*1*0#
3-اتمام پیام ( جلوگیری از اجرای گره های بعدی )
عبارت uend:  را ابتدای خروجی قرار دهید و سپس متنی که باید نمایش داده شود را بنویسید
uend:thanks