ملی ای‌پی‌آی

رفع خطای کد پستی نامعتبر

دو حالت کاملاً متفاوت: یا عدد ده رقم نیست و API همان‌جا ردش می‌کند، یا ده رقم هست ولی نشانی‌ای برایش پیدا نمی‌شود.

وقتی کد پستی «نامعتبر» اعلام می‌شود، دو اتفاق متفاوت ممکن است افتاده باشد. تشخیصشان ساده است، و راه‌حلشان یکی نیست.

حالت اول: ورودی نامعتبر است

این خطا پیش از استعلام گرفته می‌شود و پاسخ invalid_input برمی‌گردد. یعنی درخواستی به سامانهٔ مرجع نرفته و هزینه‌ای هم کسر نشده است.

علت‌های رایجش:

  • تعداد ارقام ده تا نیست. یک رقم کم یا زیاد کافی است.
  • شناسه قبض به‌جای کد پستی وارد شده. شناسه قبض می‌تواند تا ۱۳ رقم باشد و اشتباه‌گرفتنشان رایج است.
  • همه ارقام یکسان‌اند. عددی مثل ده‌تا یک، کد پستی نیست و پذیرفته نمی‌شود.
  • کاراکتر اضافه از کپی آمده. وقتی عدد را از پیامک یا سند کپی می‌کنید، گاهی کاراکترهای نامرئی همراهش می‌آیند.

خط تیره، فاصله و ارقام فارسی هیچ‌کدام مشکل‌ساز نیستند.

حالت دوم: نشانی پیدا نشد

اینجا عدد از اعتبارسنجی ورودی گذشته، استعلام انجام شده، و پاسخ آمده: برای این کد پستی نشانی‌ای برنگشت.

این یک پاسخ معتبر است، نه خطای سرویس. استعلام کار خودش را کرده و جوابش این بوده، پس رسیدش صادر می‌شود.

علت‌های ممکن:

  • کد پستی درست خوانده نشده، رقم‌های ۵ و ۶ یا ۱ و ۷ در دست‌نوشته شبیه هم می‌شوند.
  • نشانی تازه است و هنوز ثبت نشده.
  • کدی که به شما داده‌اند از اول اشتباه بوده.

کاری که باید کرد

  1. عدد را از منبع اصلی دوباره بخوانید، نه از حافظه.
  2. اگر روی کاغذ نوشته شده، ارقام شبیه‌به‌هم را با دقت بررسی کنید.
  3. مطمئن شوید آنچه دارید کد پستی است، نه شناسه قبض یا شماره اشتراک.

چرا بررسی سخت‌گیرانه‌تری انجام نمی‌دهیم

می‌شد قواعد بیشتری روی ارقام اعمال کرد تا خطاها زودتر گرفته شوند. عمداً این کار را نکرده‌ایم.

دلیلش ساده است: قواعد سخت‌گیرانه، کد پستی‌های واقعی را هم رد می‌کنند و کاربر را بدون راه‌حل رها می‌کنند. بهتر است استعلام انجام شود و پاسخ «پیدا نشد» بدهد، تا اینکه API چیزی را رد کند که درست بوده است.

اگر این را در برنامه‌تان لازم دارید، تبدیل کد پستی به آدرس همان کار را با API انجام می‌دهد و برای ادامهٔ بحث، کد پستی ده‌رقمی چیست را بخوانید.

آخرین بازبینی: تیم تحریریه ملی ای‌پی‌آی

وب‌سرویس مرتبط با این راهنما

API تبدیل کد پستی به آدرس

نشانی متناظر با یک کد پستی ده‌رقمی.

مشاهده مشخصات فنی و تعرفه

راهنماهای مرتبط

پرسش و تجربه کاربران

اگر این راهنما جوابتان را نداد، همین‌جا بپرسید. پرسش‌ها را تیمملی ای‌پی‌آی پاسخ می‌دهد و هر نظر پیش از انتشار بررسی می‌شود.

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