وب سرویس دریافت اطلاعات فرم سریع USSD
وب سرویس جاری به شما این امکان را میدهد که گزارشی جامع ازفرمهای سریع تکمیل شده کاربران را به صورت JSON دریافت کنید.
ارسال اطلاعات
برای ارسال پارامترهای ورودی میبایست ابتدا به وب سرویس با آدرس https://login.inoti.com/_Services/USSD.asmx متصل شوید و تابع GetFilledForm را فراخوانی کنید. تابع GetFilledForm دارای 16 پارامتر ورودی مطابق جدول زیر میباشد که میبایست به صورت GET به تابع ارسال شود.
Description | Variable Type | Variable Name |
---|---|---|
نام کاربری (اجباری) | String | Username |
رمز عبور (اجباری) | String | Password |
کد USSD و منو فراخوانی شده | String | FullCode |
نتیجه پرداخت | String | IsPayed |
کد رهگیری فرم تکمیل شده | String | FormRefKey |
عنوان فرم | String | FormTitle |
نام فرد تکمیل کننده | String | FirstName |
نام خانوادگی فرد تکمیل کننده | String | LastName |
موبایل فرد تکمیل کننده | String | Mobile |
کد ملی فرد تکمیل کننده | String | NaCode |
ایمیل فرد تکمیل کننده | String | |
آدرس فرد تکمیل کننده | String | Address |
تاریخ تولد فرد تکمیل کننده | String | BDate |
بازه ابتدایی تاریخ (شمسی) | String | DateFrom |
بازه انتهایی تاریخ (شمسی) | String | DateTo |
وضعیت فرم | String | Status |
نمونه کد C#
USSD.CS
private void GetFilledForm()
{
com.inoti.login.USSD MyService = new com.inoti.login.USSD();
string Username,//اجباری
string Password,//اجباری
string FullCode = "*6655*12*25#",//اختیاری
string IsPayed = "",//اختیاری 0-پرداخت نشده 1-پرداخت شده خالی-همه موارد
string FormRefKey = "12443",//اختیاری
string FormTitle = "فرم استخدام برنامه نویس", //اختیاری
string FirstName = "مهران",//اختیاری
string LastName = "احمدی",//اختیاری
string Mobile = "09121231234",//اختیاری
string NaCode = "0123456789",//اختیاری
string Email = "test@gmail.com",//اختیاری
string Address = "تهران - پلاک 12",//اختیاری
string BDate = "1350/03/12", //اختیاری
string DateFrom = "1400/09/22", //اختیاری
string DateTo = "1400/09/24", //اختیاری
string Status = " (0-ارسال لینک 1- تکمیل شده 2- آرشیو شده 9- حذف شده خالی- همه موارد ) "
var JsonResult = MyService.GetFilledForm(Username, Password, FullCode,IsPayed,FormRefKey,FormTitle,FirstName,LastName,Mobile,NaCode,Email,Address,BDate, DateFrom, DateTo,Status);
}
پاسخ دریافتی
پاسخ دریافتی به صورت JSON میباشد که در هر Section تعداد 26 متغیر مشاهده میشود که در جدول زیر قابل مشاهده میباشد
Description | Variable |
---|---|
کد رهگیری فرم پر شده | FormRefKey |
نام | FirstName |
نام خانوادگی | LastName |
موبایل | Mobile |
کد ملی | NaCode |
ایمیل | |
تلفن | Phone |
آدرس | Address |
تاریخ تولد | BirthDate |
توضیحات | Description |
فیلد دلخواه 1 | CustomField1 |
فیلد دلخواه 2 | CustomField2 |
فیلد دلخواه 3 | CustomField3 |
فیلد دلخواه 4 | CustomField4 |
فیلد دلخواه 5 | CustomField5 |
فیلد دلخواه 6 | CustomField6 |
فیلد دلخواه 7 | CustomField7 |
فیلد دلخواه 8 | CustomField8 |
فیلد دلخواه 9 | CustomField9 |
فیلد دلخواه 10 | CustomField10 |
زمان ساخت فرم | CreateDateTime |
شماره کامل منوی فرم تکمیل شده | FullUSSDCode |
وضعیت فرم | Status |
مبلغ پرداخت شده | Price |
کد رهگیری بانک | BankRefKey |
لوکیشن وارد شده در فرم | Location |
همچنین در صورتی که هیچ نتیجه ای در تاریخ مورد نظر وجود نداشته باشد مقدار null بازگردانی میشود در ادامه نمونه پاسخ دریافتی را مشاهده میکنید
[
{
"FormRefKey": "154616",
"FirstName": "سعید",
"LastName": "احمدی",
"Mobile": "09121231234",
"NaCode": "0123456789",
"Email": "test@gmail.com",
"Phone": "",
"Address": "تهران - پلاک 12",
"BirthDate": "1350/03/12",
"Description": "",
"CustomField1": "",
"CustomField2": "",
"CustomField3": "",
"CustomField4": "",
"CustomField5": "",
"CustomField6": "",
"CustomField7": "",
"CustomField8": "",
"CustomField9": "",
"CustomField10": "",
"CreateDateTime": "1400/09/22",
"FullUSSDCode": "*6655*12*25#",
"Status": "1",
"Price": "0",
"BankRefKey": "32133546223",
"Location": "35.75110539997435,51.53779866787303"
}
]
Error های دریافتی
در صورت وجود هرگونه خطا، تابع GetFilledForm مقدار خطا را به صورت JSON برمیگرداند که مطابق جدول زیر میباشد
Description | Error Text |
---|---|
نام کاربری وارد نشده است | Username is Empty |
رمز عبور وارد نشده است | Password is Empty |
فرمت بازه ابتدایی تاریخ اشتباه است | DateFrom is not Correct |
فرمت بازه انتهایی تاریخ اشتباه است | DateTo is not Correct |
نام کاربری وارد شده اشتباه است | User not Found |
رمز عبور وارد شده اشتباه است | Password is Incorrect |
کد status وارد شده اشتباه است | status is Incorrect |