API تبدیل کد پستی به آدرس
با یک کد پستی دهرقمی، نشانی ثبتشدهٔ آن را در فیلدهای جدا برمی‌گرداند تا فرم خرید و ارسال کوتاه شود.
این سرویس چه میکند
مشتری در تسویهحساب فقط کد پستی‌اش را می‌نویسد و فرم، استان، شهر و خیابان را خودش پر میکند. بقیهٔ کار تنها پلاک و واحد است. اینجا سرویس استعلام آدرس با کد پستی کار میکند: ورودی یک کد دهرقمی است و خروجی، نشانی ثبت‌شده برای همان کد.
کد پستی با خط تیره یا ارقام فارسی هم پذیرفته میشود و پیش از ارسال به ده رقم لاتین تبدیل میشود. فقط دو چیز رد میشود: طول غیر از ده رقم و ده رقم تکراری مثل ۱۱۱۱۱۱۱۱۱۱. اعتبار واقعی را همان استعلام تعیین میکند.
نشانی در ده فیلد جدا میآید
در نمونهٔ سرویس مرجع، نشانی از ده بخش ساخته شده است: استان، شهر، محله، خیابان اصلی، خیابان فرعی، پلاک، طبقه، سمت طبقه، نام ساختمان و توضیحات. استان و شهر و محله را مستقیم در فرم بگذارید و خیابان را بخوانید، ولی این را پیشفرض نکنید که همه پر باشند.
مقدار «-» یعنی خالی
بخش‌هایی که برای آن کد ثبت نشده‌اند، در نمونهٔ مرجع با خط تیره پر شده‌اند و خالی نیستند. طبقه ممکن است رشته‌ای مثل «-۱» باشد و پلاک عدد. پیش از نمایش، مقدار «-» را حذف کنید و طبقه را عدد فرض نکنید، وگرنه مشتری نشانی‌ای می‌بیند که انگار نیمه‌کاره است.
آنچه این سرویس نمی‌کند
نام ساکن، تلفن یا مالک ملک را نمی‌دهد و مختصات هم برنمی‌گرداند؛ مختصات سرویس جداگانهٔ مختصات کد پستی است. کد پستی را از روی نشانی هم نمیسازد: ورودی فقط کد است.
اختلاف با نشانی مشتری
نتیجه را در فیلدی بگذارید که مشتری بتواند دستش بزند. اگر مشتری استان یا خیابان را جور دیگری نوشته، به‌جای رد کردن، هر دو را کنار هم نشان بدهید و بپرسید کدام درست است. پیدا نشدن کد، پاسخ معتبر است و صورتحساب میشود؛ پس پیش از زدن دکمه، طول دهرقمی را در فرم بسنجید.
کجا به کار میآید
- تسویهحساب فروشگاه آنلاین پوشاکمشتری کد پستی را می‌نویسد و استان، شهر و خیابان پر میشود. فقط پلاک و واحد را خودش تایپ میکند و فرم نصف میشود.
- ثبت‌نام مشتری در شرکت خدمات پس از فروشنشانی‌ای که مشتری برای نصب یا تعمیر اعلام کرده با نشانی کد پستی مقایسه میشود و اختلاف استان قبل از اعزام تکنسین دیده میشود.
- ثبت آدرس انبار فروشنده در بازارگاهفروشنده با کد پستی انبارش نشانی را تأیید میکند و پیک‌ها آدرس یکدستی دریافت می‌کنند، نه متن دستنویس.
ورودی و خروجی
ورودی
postalCodestringکد پستیده رقم.خروجی
addressobjectقیمت و شرط پرداخت
قیمت هر فراخوان API تبدیل کد پستی به آدرس ۳٬۹۰۰ تومان است.
| تعداد استعلام در ماه | قیمت هر استعلام |
|---|---|
| همهٔ فراخوان‌ها | ۳٬۹۰۰ تومان |
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان
پرسش‌های متداول
چطور از روی کد پستی نشانی را پیدا کنم؟
کد دهرقمی را بفرستید تا نشانی ثبتشدهٔ آن در فیلدهای جدا برگردد: استان، شهر، محله، خیابان، پلاک، طبقه و توضیحات. پلاک دقیق و واحد را باید مشتری تکمیل کند.
اگر کد پستی را ندارم، میشود از روی کد ملی یا نشانی آن را گرفت؟
نه. این سرویس فقط کد پستی دهرقمی میگیرد. کد ملی یا متن نشانی ورودی آن نیست و کد پستی را هم از روی نشانی نمیسازد. برای پیدا کردن کد باید از کانالهای پست استفاده کرد.
نشانی برگشتی با آنچه روی قبض نوشته فرق دارد، چرا؟
نشانی از پایگاه کد پستی میآید و ممکن است با نشانی دستنویس یا قبض در نگارش یا نام محله فرق کند. نشانی را قابل ویرایش بگذارید و اگر فرق جدی بود از کاربر تأیید بگیرید.
مقدار خط تیره در فیلدها یعنی چه؟
یعنی آن بخش برای این کد ثبت نشده است. در نمونهٔ مرجع نام ساختمان و توضیحات با «-» پر شده‌اند. مقدار «-» را پیش از نمایش حذف کنید و طبقه را همیشه عدد فرض نکنید.
اطلاعات ساکن یا مالک ملک را هم نشان می‌دهد؟
نه. پاسخ فقط نشانی است. نام ساکن، مالک یا تلفن در آن نیست. اگر مختصات لازم دارید، سرویس مختصات کد پستی جداست و در این فراخوان برنمی‌گردد.
اگر کد پستی پیدا نشود، هزینه دارد؟
بله. «پیدا نشد» پاسخ معتبری است که با HTTP ۲۰۰ و ok:false برمی‌گردد و صورتحساب میشود. ورودی نامعتبر، مثل طول غیر دهرقمی، هزینه ندارد، پس طول را قبل از فراخوان در فرم بسنجید.
حد نرخ این سرویس چند فراخوان در دقیقه است؟
پیشفرض شصت فراخوان در دقیقه برای هر سرویس است. در فرم زندهٔ تسویهحساب با تعداد زیاد کاربر همزمان، فراخوان را فقط پس از کاملشدن ده رقم بزنید، نه با هر کلید.
نتیجه را میتوانم ذخیره کنم؟
بله، نشانی یک کد پستی کم تغییر میکند. ما هم پاسخ را در کش نگه میداریم و source.cached میگوید پاسخ از کش بود یا تازه. برای نشانی سفارشهای قبلی، نسخهٔ خودتان را نگه دارید.