• مدیر سایت
• آذر ۱۷, ۱۳۹۸

برخی از متدهای API استعلام

در مطالب قبل در مورد معرفی وب سرویس استعلام و همچنین مستندات وب سرویس استعلام صحبت کردیم در این مطلب در مورد متدهای وب سرویس استعلام و نمونه کد آن صحبت خواهیم کرد

استعلام کد ملی

پارامتر	نوع	پارامتر
کد ملی	Char	IdCode
تاریخ تولد	Date	BirthDate

پارامتر های خروجی

پارامتر	نوع	پارامتر
کد ملی	Char	IdCode
صحت اطلاعات	Boolean	Validation
نام	Char	Name
نام خانوادگی	Char	Family
نام پدر	Char	FatherName
جنسیت	Char	Gender
شماره شناسنامه	Char	NationalId
سری شناسنامه	Char	Serial
تاریخ تولد	Date	BirthDate
وضعیت حیات	Boolean	Life
وضعیت سرپرستی	Boolean	Guardianship
عکس	Image	Photo
استان	Char	Province
شهر	Char	City

نمونه کد

درخواست اطلاعات از طریق URL:

http://185.159.153.52/:80?token=mytoken&IdCode=1111111111&BirthDate=1364/03/31&op=IdCode

درخواست اطلاعات :

$parametr = array(
    "token"=>"",
    "op"=>"IdCode",
    "IdCode"=>"111111111",
    "BirthDate"=>"1364/03/31"
);

نتیجه

{
    "Result": {
      "IdCode": "1111111111",
      "Validation": true,
      "Name": "محمد",
      "Family": "مطهری",
      "FatherName": "احمد",
      "Gender": "مرد",
      "NationalId": "41",
      "Serial": "13614214 د 22",
      "BirthDate": "1364/03/31",
      "Life": true,
      "Guardianship": false,
      "Photo": "data:image/jpeg;base64,/9j/4R+kRXhpZgAATU0AKgAAAAgABwESAAMAAAAAAagEoA",
      "Province": "تهران",
      "City": "ورامین"
    }
}

استعلام صحت کدملی

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

پارامتر	نوع	پارامتر
کد ملی	Char	IdCode
تاریخ تولد	Date	BirthDate
نام	Char	Name
نام خانوادگی	Char	Family
نام پدر	Char	FatherName
شماره شناسنامه	Char	NationalId

پارامتر های خروجی

پارامتر	نوع	پارامتر
صحت اطلاعات	Boolean	Validation
توضیحات	Char	Detail

نمونه کد

درخواست اطلاعات از طریق URL:

http://185.159.153.52/:80?token=mytoken&IdCode=1111111111&BirthDate=1364/03/31&Name=محمد&Family=موسوی&FatherName=احمد&NationalId=41&op=NationalCode

درخواست اطلاعات :

$parametr = array(
    "token"=>"",
    "op"=>"NationalCode",
    "IdCode"=>"111111111",
    "BirthDay"=>"1364/03/31",
    "Name"=>"محمد",
    "Family"=>"موسوی",
    "FatherName"=>"احمد",
    "NationalId"=>"41"
);

نتیجه :

{
    "Result": {
      "Validation": false,
      "Detail": "نام خانوادگی با اطلاعات ثبت احوال مغایرت دارد"
    }
}

نکته
کد ملی وتاریخ تولد الزامی می باشد سایر موارد اختیاری بوده و بر اساس متغییر های ارسال شده صحت اطلاعات بررسی می گردد

 

استعلام کد پستی

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

پارامتر	نوع	پارامتر
کد پستی	Char	PostalCode

پارامتر های خروجی

پارامتر	نوع	پارامتر
کد پستی	Char	PostalCode
صحت کدپستی	Boolean	Validation
استان	Char	Province
شهرستان	Char	County
شهر	Char	City
آدرس	Char	Adress
تلفن ثابت	Char	Tel

نمونه کد

درخواست اطلاعات از طریق URL:

http://185.159.153.52/:80?token=mytoken&PostalCode=1111111111&op=PostalCode

درخواست اطلاعات :

$parametr = array(
    "token"=>"",
    "op"=>"PostalCode",
    "PostalCode"=>"1111111111"
);

نتیجه :

{
    "Result": {
      "Validation": true,
      "PostalCode": "1111111111",
      "Province": "فارس",
      "County": "شیراز",
      "City": "شیراز",
      "Adress": "شهرک ارین ، کوچه 2 ، خیابان شبنم ، پلاک 3 ، طبقه چهارم",
      "Tel": "07138702200",
    }
}

منبع

• برچسب ها:
• api استعلام
• مستندات api استعلام
• مستندات وب سرویس استعلام
• نمونه کد api استعلام
• نمونه کد وب سرویس استعلام
• وب سرویس استعلام