API تبدیل فارسی به فینگلیش
متن فارسی را با حروف انگلیسی می‌نویسد تا نام و نشانی در سامانه‌ها و فرم‌هایی که فقط لاتین می‌پذیرند ثبت شود.
این سرویس چه میکند
مشتری در فروشگاه اینترنتی فقط «علیرضا نوری‌زاده» را نوشته، اما فرم ثبت سفارش بین‌المللی نام لاتین می‌خواهد. او باید بنویسد Alireza یا Ali Reza؟ تبدیل فارسی به فینگلیش این تصمیم را از دوش مشتری برمی‌دارد: متن فارسی می‌دهید و معادل لاتین‌شده برمیگردد.
ورودی یک فیلد به نام persianText است که بعد از حذف فاصلهٔ ابتدا و انتها باید بین دو تا دویست نویسه باشد. خروجی در data با کلید finglish_text میآید و در نمونهٔ سرویس مرجع حروف کوچک لاتین است، مثل mohammad naderi.
نام لاتین یکتا نیست
یک نام فارسی چند نگارش لاتین رایج دارد. «محمد» را در مدارک مختلف Mohammad، Mohammed، Muhammad و Mohamad می‌بینید و هیچ استاندارد واحد و اجباری میان آن‌ها حَکَم نیست. پس خروجی این سرویس یک نگارش معقول است، نه نگارش ثبتشده در گذرنامهٔ فرد. هر جا نام باید دقیقاً با مدرک بخواند، نتیجه را به کاربر نشان بدهید تا اصلاح کند.
دو کار که بهتر از نمایش مستقیم است
به‌عنوان کلید جست‌وجو: نام فارسی مشتری را یک بار به فینگلیش ببرید و در ستونی جدا ذخیره کنید. بعد جست‌وجوی «alireza» نام «علیرضا» را در CRM پیدا میکند. دومی، پیشنهاد نام کاربری یا نشانی ایمیل: خروجی را بعد از برداشتن فاصله‌ها و حروف غیرمجاز به‌عنوان پیشنهاد نشان بدهید.
آنچه این سرویس نمی‌کند
ترجمه نمی‌کند: «خیابان» به khiaban می‌رسد، نه street. زبان را هم تشخیص نمی‌دهد و نگارش گذرنامه را تضمین نمی‌کند. برای متن‌های بسیار طولانی هم ساخته نشده است، چون سقف ورودی دویست نویسه است.
هزینه و تکرار
هر فراخوان موفق صورتحساب میشود. برای نام‌هایی که بارها لازم می‌شوند، پاسخ را در پایگاه داده‌تان ذخیره کنید و دوباره نپرسید. ورودی کوتاه‌تر از دو نویسه پاسخ invalid_input می‌گیرد و هزینه ندارد.
کجا به کار میآید
- فرم سفارش بین‌المللی در فروشگاه صنایع‌دستینام و نشانی مشتری ایرانی برای ثبت در سامانهٔ حمل بین‌المللی به لاتین تبدیل میشود و مشتری فقط آن را تأیید یا اصلاح میکند.
- جست‌وجوی لاتین در CRM باشگاه مشتریاننام فارسی هر عضو به فینگلیش برده و در ستون جداگانه ذخیره میشود تا پشتیبانی بدون صفحه‌کلید فارسی هم عضو را پیدا کند.
- پیشنهاد نام کاربری در ثبت‌نام اپلیکیشناز نام فارسی کاربر چند نام کاربری لاتین پیشنهاد میشود تا تایپ و حفظش ساده‌تر باشد.
ورودی و خروجی
ورودی
persianTextstringمتن فارسیدو تا دویست نویسه.خروجی
finglish_textstringmohammad naderiقیمت و شرط پرداخت
قیمت هر فراخوان API تبدیل فارسی به فینگلیش ۹۰۰ تومان است.
| تعداد استعلام در ماه | قیمت هر استعلام |
|---|---|
| همهٔ فراخوانها | ۹۰۰ تومان |
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان
پرسش‌های متداول
فینگلیش چیست و چه فرقی با ترجمه دارد؟
فینگلیش نوشتن متن فارسی با حروف انگلیسی است، مثل «سلام» که salam نوشته میشود. ترجمه معنا را عوض میکند، اما این سرویس فقط شکل نوشتن را عوض میکند و «خیابان» را khiaban میکند، نه street.
چرا محمد به چند شکل Mohammad و Muhammad نوشته میشود؟
چون هیچ نگارش لاتین واحد و اجباری برای نامهای فارسی و عربی وجود ندارد و مصوتهای کوتاه در نوشتار فارسی نیامدهاند. پس خروجی سرویس یک نگارش رایج است و ممکن است با شکل ثبتشده در مدرک فرد فرق کند.
برای فرم‌ها و مدارک کدام املای لاتین را بنویسم؟
همان املایی که در گذرنامه یا مدرک هویتی فرد ثبت شده است. خروجی این سرویس را برای پیش‌پر کردن فرم به کار ببرید و به کاربر اجازه بدهید دقیقاً مطابق مدرک اصلاح کند.
آیا کتابخانهٔ آماده بهجای API هم هست؟
کتابخانههای متنباز برای کارهای نزدیک هست، ولی هر کدام قواعد خودش را دارد و خروجیشان یکی نیست. اگر نگارش یکدست و قابلارجاع در سیستم میخواهید، پاسخ این سرویس را ذخیره کنید و هر بار از همان استفاده کنید.
ورودی چه محدودیتی دارد؟
فیلد persianText پس از حذف فاصلهٔ ابتدا و انتها باید بین دو تا دویست نویسه باشد. کوتاه‌تر یا بلندتر از آن پاسخ invalid_input می‌گیرد و هزینه‌ای کسر نمی‌شود.
خروجی چه شکلی است؟
در data یک رشته با کلید finglish_text برمیگردد. در نمونهٔ مرجع حروف کوچک لاتین و با فاصله بین کلمات است، مثل mohammad naderi. بزرگکردن حرف اول برای نمایش با خودتان است.
هر فراخوان چقدر از موجودی کم میکند؟
مبلغ از تعرفهٔ زندهٔ حساب شما میآید و در فیلد billing.amountRial هر پاسخ نوشته شده است. فراخوانی که به سرویس مرجع نرسد، ورودی نامعتبر و سقف نرخ هزینه ندارند.
حد نرخ این سرویس چقدر است؟
پیشفرض شصت فراخوان در دقیقه برای هر سرویس است. برای تبدیل دستهای هزاران نام، فراخوانها را پخش کنید یا بخواهید سقف حسابتان بالا برده شود. پاسخ ۴۲۹ هزینه ندارد.