API استعلام کد پستی
استعلام کد پستی با API بازارپی: آدرس کامل یا طول و عرض جغرافیایی را از روی کد پستی بگیرید؛ مناسب فروشگاه‌ها و سرویس‌های ارسال.
دو سرویس کد پستی بازارپی، ورود آدرس را برای کاربران و کسب‌وکارها ساده و دقیق می‌کنند: «کد پستی به آدرس» آدرس کامل را از روی کد پستی برمیگرداند و «کد پستی به مختصات» طول و عرض جغرافیایی همان کد پستی را.
به جای اینکه کاربر آدرس را دستی و با خطا تایپ کند، فقط کد پستی را وارد می‌کند و آدرس استاندارد را می‌بینید. مسیرها /ide/v1/services/postal و /ide/v1/services/postal/wgs هستند و هر دو با متد GET فراخوانی می‌شوند.
برای استفاده، در بازارپی ثبت‌نام کنید، سرویس را درخواست دهید و پس از تأیید، کلید API بسازید. یک جفت کلید برای همه سرویس‌ها کار می‌کند، دسترسی هر کلید را می‌توانید به IP سرورهای خود محدود کنید و با «کلید تست» پاسخ نمونه بدون کسر هزینه بگیرید. هزینه به ریال و فقط برای درخواست‌های موفق از کیف پول (پیش‌پرداخت) یا سقف اعتبار (پس‌پرداخت) کسر می‌شود؛ خطاهای سمت ارائهدهنده (۵xx) هرگز محاسبه نمیشوند.
کاربردها
- تکمیل خودکار آدرس ارسال در فروشگاه اینترنتی
- بررسی آدرس اعلامی مشتری یا پذیرنده
- نمایش موقعیت روی نقشه یا محاسبه فاصله با مختصات کد پستی
سرویس‌ها و قیمت
جزئیات کامل درخواست و پاسخ در مرجع API و نحوه دریافت توکن در راهنمای فنی آمده است.
سؤالات متداول
تفاوت دو سرویس کد پستی چیست؟
«کد پستی به آدرس» آدرس کامل را برمیگرداند و «کد پستی به مختصات» طول و عرض جغرافیایی را؛ هر کدام قیمت جداگانه دارد.
هزینه این سرویس چطور محاسبه می‌شود؟
قیمت هر سرویس به ریال در همین صفحه و کاتالوگ آمده است. فقط درخواست‌های موفق (و طبق قوانین هر سرویس) محاسبه می‌شوند، خطاهای سمت ارائهدهنده و قطعی ارتباط هرگز هزینه ندارند و مالیات بر ارزش افزوده جداگانه در صورتحساب می‌آید.
میتوانم پیش از استفاده واقعی تست کنم؟
بله. با «کلید تست» در پنل، درخواستها همه بررسیهای عادی را میگذرانند اما به ارائهدهنده ارسال نمیشوند؛ پاسخ نمونه با همان ساختار مرجع API برمیگردد و هزینهای کسر نمیشود.