استعلام گذرنامه
خدمت‌دهنده
عصر داده
مقدمه
پادیوم دارای مجموعه‌ای فعال در حوزه زیرساخت با رویکرد خلق ارزش افزوده بر مبنای ارائه سرویس های جدید در حوزه فینتک فعالیت میباشد. یکی از مهمترین محصولات پادیوم در این زمینه مجموعه سرویس های استعلامی میباشد که از آن میتوان به ارائه خدمات استعلامی و هویتی برای موسسات مالی و همچنین به کارگیری هوش مصنوعی در حوزه‌های مرتبط با فینتک اشاره کرد.
فعالسازی سرویس
ارسال درخواست در سایت پادیوم www.podium.ir:
ابتدا وارد سایت پادیوم شده، سپس در بازارچه‌ی API، سرویسهای مورد نظر خود را انتخاب و درخواست استفاده از آن مجموعه سرویس را ارسال کنید.
درخواست شما توسط کارشناسان پادیوم، بررسی شده و بعد از تایید آن می‌توانید از طربق پنل کسب و کار خود اقدام به دریافت کلید اتصال مربوط به آن سرویس نمایید.
منو: پنل کسب و کار – منوی میزکار سرویس گیرنده – درخواستهای ارسالی – در بخش مربوط به سرویس مورد نظر با کلیک بر روی "جزئیات درخواست"
درلیست باز شده با کلیک بر روی تصویر کلید سمت چپ هر سطر جدول می‌توانید ApiKey مربوط به آن سرویس را دریافت و ذخیره کنید.
لینک پنل کسب و کار https://panel.pod.ir/Businesses/Requestwebservices
نکته : این کلید در تمام درخواستهای ارسالی از آن سرویس ، ثابت است تا زمانی که کلید جدیدی برای آن سرویس دریافت نشود و به محض دریافت مقدار جدید برای سرویس مورد نظر, کلید قبلی منقضی خواهد شد.
-این کلید در فیلد scApiKey در بخش body درخواست HTTP ، استفاده می شود.
دریافت کلیدهای سرویس یک (دسته/مجموعه) سرویس در قالب یک فایل:
بعداز فشردن دکمه ی تایید سرویس در پنجره باز شده بالا ، برای تمامی سرویسهای موجود در پنل می‌توانید از گزینه "دریافت فایل خروجی"، لیست کاملی از سرویس‌ها و کلیدهای scApiKey متناظر با هر یک را دریافت کنید.
استعلام گذرنامه
در این سرویس با دریافت شماره تلفن همراه به عنوان ورودی مشخصات گذرنامه شخص را در خروجی نمایش میدهد.
- شناسه سرویس : 9114436
- شناسه سرویس سندباکس: 168899
- پارامتر ورودی سرویس
| نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
| body | Json | اجباری | پارامتر درخواست |
- مشخصات پارامتر درخواست (Body)
| نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
| NationalId | string | اجباری | شماره ملی |
| Mobile | string | اجباری | شماره همراه |
- نمونه درخواست پارامتر body:
- پارامتر های خروجی:
| نام پارامتر | نوع | توضیحات |
| hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
| messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
| referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
| errorCode | int | کد ارور پلتفرمی. |
| Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
| Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
| Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
- نمونه پاسخ موفق:
- نمونه پاسخ ناموفق
- در صورت استعلام موفق فیلدهاي خروجی به صورت Json :
| نام پارامتر | نوع | توضیحات |
| Status | String | کد (جدول پایانی) |
| Message | String | پیام سرویس |
| Data | Json | اطلاعات پاسخ |
مشخصات پارامتر Data :
| نام پارامتر | نوع | توضیحات |
| PostalBarcode | String | بارکدپستی |
| HasPassport | String | (true,false) گذرنامه حاوي |
| PassportNumber | String | شماره گذرنامه |
| ExportDate | String | تاریخ صدور |
| ExpireDate | String | تاریخ انقضاء |
| PassportStatus | String | وضعیت گذرنامه |
| RequestStatus | String | وضعیت درخواست |
کدهای خطای سرویس اصلی
| کد خطا | عنوان | توضیحات |
| 0 | Success | موفق |
| 101 | Access No | اجازه دسترسی ندارید |
| 102 | Empty is Type Bill | نوع قبض ارسال نشده است |
| 103 | Empty is Parameter Bill | پارامتر استعلام ارسال نشده است |
| 104 | Parameter Worng | مقدار ورودي نامعتبر است |
| 105 | Bill Paid | قبض پرداخت شده است |
| 106 | No Bill | قبضی یافت نشد |
| 107 | Bill Worng Type | نوع قبض اشتباه است |
| 108 | Disabled Totally Service | استعلام فعال نیست |
| 109 | User For Disabled Service | استعلام مورد نظر شما فعال نمیباشد |
| 110 | Disabled Service | سرویس با اختلال همراه است |
| 111 | Region Not Exists | منطقه یافت نشد |
| 112 | Region Not Supported | منطقه پشتیبانی نمیشود |
| 113 | Bill is Empty | آرایه قبوض ارسال نشده است |
| 114 | Invalid Bills Data | مقدار آرایه قبوض ارسال نشده است |
| 131 | Tel Activation Error | خطا در درخواست فعالسازی تلفن |
| 132 | Tel Number is Empty | شماره تلفن ارسال نشده است |
| 133 | Tel Number is Worng | شماره تلفن نامعتبر است |
| 134 | Activation Code is Empty | کد فعالسازی ارسال نشده است |
| 135 | This Tel Does Not Require Verification | شماره نیاز به فعالسازی ندارد |
| 136 | Tel Request Actiovation Code Required | شماره تلفن ابتدا باید فعالسازی شود |
| 137 | Package Not Exists | اشتراک یافت نشد |
| 140 | Used Credit Package | حجم استعلام به اتمام رسیده است |
| 141 | Mobile is Empty | شماره همراه ارسال نشده است |
| 142 | Mobile is Invalid | شماره همراه نامعتبر است |
| 143 | Mobile Is Empty | کد ارسال نشده است |
| 144 | Service Error | خطای سرویس |
| 150 | Maximum Transaction Per Second Reached | حداکثر حجم تراکنش در ثانیه است |
| 151 | Pay Request Id is Empty | شناسه درخواست ارسال نشده است |
| 152 | Pay Request Id Is invalid | شناسه درخواست صحیح نیست |
| 153 | Pay Request Id Not Exists | شناسه درخواست نامعتبر است |
| 154 | Pay Request Id Processed | درخواست پرداخت قبلا بررسی شده است |
| 155 | User Credit Is Not Enough | اعتبار کاربر جهت پرداخت کافی نمیباشد |
| 156 | Pay Request Failed | درخواست پرداخت ناموفق شده است |
| 157 | No Bill Has Exported | قبضی صادر نشده است |
| 201 | Mobile Is Empty | شماره همراه ارسال نشده است. |
| 202 | Invalid Is Mobile | شماره همراه نادرست است. |
| 203 | Empty Is NID | شماره ملی وارد نشده است |
| 204 | Invalid Is NID | شماره ملی نادرست است |
| 205 | Error | خطا |
| 206 | OTP Is Empty | کد یکبار مصرف ارسال نشده است |
| 207 | TrackId is Empty | کد پیگیری ارسال نشده است |
| 208 | TrackID is Invalid | کد پیگیری نادرست است |
| 209 | TrackId used before | کد پیگیری قبلا استفاده شده است |
| 211 | Verifysms Error | خطا در تایید احراز هویت و کدیکبار مصرف |
| 212 | Get AccessTOken Error | خطا |
| 213 | Credit Type Is Invalid | نوع اعتبار سنجی نادرست است |
| 214 | Code Is Invalid | کد اعتبار سنجی نادرست است |
| 215 | UnAuthorized Request. SMS Verification Required | درخواست نامعتبر است، احراز هویت مورد نیاز است |
| 216 | Invalid Is Type Service | نوع درخواست بانکی نامعتبر است |
| 217 | Code is Invalid | کد اعتبارسنجی نادرست است |
| 218 | Code is Empty | کد اعتبارسنجی ارسال نشده است |
| 221 | Credited In Last 24 Hours | در24ساعت گذشته اعتبارسنجی شده است |
| 222 | SMS Verification Required | احراز هویت مورد نیاز است |
| 225 | Service Error | خطا |
| 231 | Empty Is Number Cheque | شماره چک ارسال نشده است |
| 232 | Cheque Number is Invalid | شماره چک اشتباه است |
| 233 | Information Not Found | اطلاعات یافت نشد |
| 238 | DueDate in Invalid | تاریخ سررسید ارسال نشده است |
| 239 | DueDate in invalid | تاریخ سررسید نامعتبر است |
| 240 | UserType in Empty | نوع شخص گیرنده چک ارسال نشده است |
| 241 | UserType in Invalid | نوع شخص گیرنده چک نامعتبر است |
| 242 | Amount in Empty | مبلغ چک ارسال نشده است |
| 243 | Amount Is Invalid | مبلغ چک نامعتبر است |
| 244 | BillId Is Empty | شناسه قبض ارسال نشده است |
| 245 | BillId is Invalid | شناسه قبض نامعتبر است |
| 246 | Empty Is PayId | شناسه پرداخت ارسال نشده است |
| 247 | PayId is Invalid | شناسه پرداخت نامعتبر است |
| 248 | Service faild | خطای سرویس |
| 249 | Transaction Not Found | تراکنش یافت نشد |
| 250 | Gateway in Invalid | درگاه پرداخت نامعتبر است. |
| 301 | License Number Is Empty | شماره گواهینامه ارسال نشده است |
| 302 | License Number Is Invalid | شماره گواهینامه نادرست است |
| 303 | Information Not Found | اطلاعات یافت نشد |
| 304 | Plate Number Is Empty | شماره پلاك ارسال نشده است |
| 305 | Plate Number Is Invalid | شماره پلاك نادرست است |
| 306 | National Id Is Empty | کد ملی ارسال نشده است |
| 307 | National Id Is Invalid | کد ملی نادرست است |
| 308 | VIN Is Empty | شماره VIN ارسال نشده است |
| 309 | VIN Is Invalid | شماره VIN نامعتبر است |
| 310 | Information Not Found | اطلاعات یافت نشد |
| 311 | Information Not Found | اطلاعات یافت نشد |
| 312 | Information Not Found | اطلاعات یافت نشد |
| 313 | Information Not Found | اطلاعات یافت نشد |
| 314 | Information Not Found | اطلاعات یافت نشد |
| 315 | BirthDate Is Empty | تاریخ تولد ارسال نشده است |
| 316 | BirthDate Is Invalid | تاریخ تولد نامعتبر است (xxxx/xx/xx ) |
| 317 | Mobile Is Empty | شماره همراه ارسال نشده است |
| 318 | Mobile Is Invalid | شماره همراه نامعتبر است |
| 319 | Already Registered | پیام خطا سامانه سخا (قبلا ثبت نام شده است) |
| 320 | Code Is Empty | کد ارسال نشده است |
| 321 | Code Is Invalid | کد نامعتبر است |
| 322 | Password Is Empty | رمزعبور ارسال نشده است |
| 323 | Password Is Invalid | رمزعبور نامعتبر است |
| 333 | Registration Not Found OR Code Is Invalid | ثبت نام یافت نشد یا کد نامعتبر است |
| 334 | Forget Password Error | خطاي فراموشی رمز عبور |
| 335 | NationalId Is Empty | کدملی ارسال نشده است |
| 340 | NationalId Is Invalid | کدملی نامعتبر است |
| 341 | Barcode Is Empty | بارکد ارسال نشده است |
| 342 | Barcode Is Invalid | بارکد نامعتبر است |
| 343 | NationalId Is Empty | کدملی ارسال نشده است |
| 344 | NationalId Is Invalid | کدملی نامعتبر است |
| 345 | Service Error | خطاي سروی س استعلام |
| 346 | Mobile Is Empty | موبایل ارسال نشده است |
| 347 | Mobile Is Invalid | موبایل نامعتبر است |
| 348 | Code Is Empty | کد ارسال نشده است |
| 349 | Code Is Invalid | کد نامعتبر است |
| 351 | Inquiry Type Is Empty | نوع درخواست ارسال نشده است |
| 352 | Inquiry Type Is Invalid | نوع درخواست نامعتبر است |
| 353 | DrivingOffense Parameter Is Empty | پارامتر استعلام خلافی ارسال نشده است |
| 354 | DrivingOffense Parameter Is Invalid | پارامتر استعلام خلافی نامعتبر است |
| 355 | DrivingOffense ImageId Is Empty | شناسه تصویر تخلف ارسال نشده است |
| 356 | DrivingOffense ImageId Is Invalid | شناسه تصویر تخلف نامعتبر است |
| 357 | DrivingOffense Not Found | تخلف یافت نش د |
| 358 | Service Error | خطاي سرویس |
| 359 | NationalId And Mobile Not Match | کدملی و موبایل مطابقت ندارند |
| 360 | Code Is Wrong | کد اشتباه است |
| 401 | Input Information Not Match | اطلاعات ورودي مطابقت ندارند |
| 402 | Authentication Not Required | احراز هویت مورد نیاز نیست |
| 403 | Authentication Required | احراز هویت مورد نیاز است |
| 404 | DrivingOffense ImageId Is Wrong | شناسه تصویر تخلف اشتباه است |
| 405 | MotorCycle DrivingOffense Not Available | استعلام خلافی پایه براي موتورسیکلت امکانپذیر نمی باشد |
| 406 | Tracking Code Is Empty | شماره مرسوله ارسال نشده است |
| 501 | Image Is Invalid | تصویر نامعتبر است |
| 502 | Image Is Invalid | تصویر نامعتبر است |
| 503 | Image Type Is Invalid | نوع تصویر نامعتبر است |
| 504 | Service Error | خطای سرویس |
| 505 | Service Failed | خطای سرویس |
| 506 | Detect Faces Many Too | چندین چهره وجود دارد |
| 507 | Found Not Face | چهره یافت نشد |
| 508 | Empty Is Video | ویدئو ارسال نشده است |
| 509 | Video Is Invalid | ویدئو نامعتبر است |
| 510 | 3M Than More Is Size Image | اندازه فایل تصویر بیش از 3 مگابایت می باشد |
| 511 | 15M Than More Is Size Video | اندازه فایل ویدئو بیش از 15 مگابایت می باشد |
| 601 | Empty Is Image | تصویر ارسال نشده است |
| 602 | Image Is Invalid | تصویر نامعتبر است |
| 603 | Image Type Is Invalid | نوع تصویر نامعتبر است |
| 604 | 3M Than More Is Size Image | اندازه فایل تصویر بیش از 3 مگابایت می باشد |
| 605 | Empty Is Height | مقدار قد ارسال نشده است |
| 606 | Invalid Is Height | مقدار قد نامعتبر است |
| 607 | Service Error | خطا سرویس |
| 608 | Service Failed | خطای سرویس |
| 609 | Side One In Are Images | تصاویر از یک زاویه می باشند |
| 610 | Image Format Is Invalid | فرمت تصویر نامعتبر است |
| 611 | Detected Not Data | تصویر قابل پردازش نمیباشد |
| 612 | Wrong Is Height | مقدار قد نامعتبر است |
| 701 | Empty Is Image | تصویر ارسال نشده است |
| 702 | Image Is Invalid | تصویر نامعتبر است |
| 703 | Image Type Is Invalid | نوع تصویر نامعتبر است |
| 704 | 3M Than More Is Size Image | اندازه فایل تصویر بیش از 3 مگابایت می باشد |
| 705 | Service Error | خطای سرویس |
| 706 | Service Failed |
|
| 707 | License Plate Not Found |
|
| 16 | No HTTP resource was found 16 (401 Unauthorized) | توکن نامعتبر است |
