تبدیل نام فارسی به نام انگلیسی
خدمت‌دهنده
بازارچه پادیوم
مقدمه
این سرویس با دریافت نام و یا نام خانوادگی فارسی می تواند معادل آنها با نوشتار انگلیسی را به کاربر تحویل دهد.
نکات
- این سرویس مبتنی بر آوای کلمات توانایی تبدیل عموم نامهای فارسی به نوشتار انگلیسی را داراست.
- در ورودی های این سرویس می توان از اعراب استفاده کرد.
- این سرویس با دریافت پیشوند و پسوند تبدیل آنها به نوشتار انگلیسی را نیز انجام می دهد.
- برای بهترین عملکرد، نباید نام و نام خانوادگی در فیلدهای جا به جا وارد شوند.
- وارد کردن دست کم نام یا نام خانوادگی در ورودی لازم است.
- این سرویس در پر کردن خودکار و یکپارچه همه فرمهای آنلاین کاربرد دارد.
- این سرویس در سیستم های ثبت اطلاعات سجلی به منظور یکنوایی اسامی کاربرد دارد.
- این سرویس در سرویسهای استعلام گیری کاربرد دارد.
- داشتن چنین استانداردی در نهایت موجب بهبود فرایندهای جستجو نیز می‌گردد.
فعالسازی سرویس
ارسال درخواست در سایت پادیوم www.podium.ir :
ابتدا وارد سایت پادیوم شده ، سپس در بازارچه ی API ، سرویسهای مورد نظر خود را انتخاب و درخواست استفاده از آن مجموعه سرویس را ارسال کنید.
درخواست شما توسط کارشناسان پادیوم، بررسی شده و بعد از تایید آن می‌توانید از طربق پنل کسب و کار خود اقدام به دریافت کلید اتصال مربوط به آن سرویس نمایید.
منو: پنل کسب و کار – منوی میزکار سرویس گیرنده – درخواستهای ارسالی – در بخش مربوط به سرویس مورد نظر با کلیک بر روی "جزئیات درخواست"
درلیست باز شده با کلیک بر روی تصویر کلید سمت چپ هر سطر جدول می‌توانید ApiKey مربوط به آن سرویس را دریافت و ذخیره کنید.
لینک پنل کسب و کار https://panel.pod.ir/Businesses/Requestwebservices
نکته : این کلید در تمام درخواستهای ارسالی از آن سرویس ، ثابت است تا زمانی که کلید جدیدی برای آن سرویس دریافت نشود و به محض دریافت مقدار جدید برای سرویس مورد نظر, کلید قبلی منقضی خواهد شد.
-این کلید در فیلد scApiKey در بخش body درخواست HTTP ، استفاده می شود.
دریافت کلیدهای سرویس یک (دسته/مجموعه) سرویس در قالب یک فایل:
بعداز فشردن دکمه ی تایید سرویس در پنجره باز شده بالا ، برای تمامی سرویسهای موجود در پنل می‌توانید از گزینه "دریافت فایل خروجی"، لیست کاملی از سرویس‌ها و کلیدهای scApiKey متناظر با هر یک را دریافت کنید.
سرویس تبدیل نام فارسی به انگلیسی
شناسه سرویس اصلی : 3749011
شناسه سرویس سند باکس: 3828109
پارامترهای ورودی
| Body | ||
| توضیحات | نوع | نام پارامتر |
| نام به نوشتار فارسی که می تواند شامل پیشوند و پسوند هم باشد | String | FirstName |
| نام خانوادگی به نوشتار فارسی که می تواند شامل پسوند هم باشد | String | LastName |
| به هر تعداد پیشوند مانند دکتر، حاج و ... | String | Pishvand |
| پسوند به نوشتار فارسی | String | Pasvand |
پارامترهای خروجی
| Respone | ||
| توضیحات | نوع | نام پارامتر |
| جزئیات نتیجه از پروایدر | StringifyJSON | result.result |
| وضعیت نتیجه در پروایدر | Int | result.statusCode |
| کد خطای پادیوم. مقدار 0 به معنای بدون خطا است | Int | result.result.ErrorCode |
| پارامتر خطا دار پادیوم | String | result.result.ErrorParameter |
| متن خطای پادیوم | String | result.result.Message |
| در صورت اخذ هزینه از کاربر true خواهد بود | Boolean | result.result.PaidCall |
| متن خطای پروایدر | String | result.result.MessageAi |
| شناسه ای منحصر به فرد جهت ردگیری درخواست | String | result.result.Tracker |
| نام به نوشتار انگلیسی | String | result.result.FirstName |
| نام خانوادگی به نوشتار انگلیسی | String | result.result.LastName |
| پیشوند به نوشتار انگلیسی | String | result.result.Pishvand |
| پسوند به نوشتار انگلیسی | String | result.result.Pasvand |
نمونه مقادیر پارامترهای ورودی سرویس سند باکس
| Body | |
| مقدار | نام پارامتر |
| 3828109 | scProductId |
| سید جواد - ابوالفضل - احمد - سارا - فرزانه | FirstName |
| ساداتی - سمیعی - عسگری - کاشانی - میرقاسمی | LastName |
| دکتر - حاج - مهندس - استاد | Pishvand |
| سید محله - شهرکی | Pasvand |
نمونه درخواست و پاسخ
نمونه درخواست با مقادیر درست
Request
نمونه پاسخ موفقیت آمیز
Response
نمونه درخواست با مقادیر نادرست
Request
نمونه پاسخ خطا
Response
نمونه درخواست با مقادیر درست
Request
نمونه پاسخ خطا ناشی از مشکل در سرور
Response
کد خطاهای رسپانس
| Response | |
| کد خطا | توضیح |
| صفحه HTML با خطای 404 | منبع درخواستی در سرور پیدا نشد |
| صفحه HTML با خطای 408 | پایان مهلت زمانی سرور به کانکشن کلاینت |
| صفحه HTML با خطای 502 | خطا در دریافت در درگاه سرور از سرور پروایدر |
| صفحه HTML با خطای 503 | سرور آماده سرویس دهی نیست |
| صفحه HTML با خطای 504 | پایان مهلت زمانی درگاه دریافت کننده سرور به سرور پروایدر |
کد خطاهای پادیوم
| errorCode | |
| کد خطا | توضیح |
| 0 | بدون خطا |
| 21 | توکن کسب وکاری وارد نشده است |
| 227 | تایم اوت سرویس اصلی |
| 378 | ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است |
| 461 | وارد کردن دست کم نام یا نام خانوادگی در ورودی لازم است |
| 462 | محدودیت در نسخه سند باکس |
| 999 | خطای داخلی سیستم |
| result.result.ErrorCode | |
| کد خطا | توضیح |
| 0 | بدون خطا |
| 10 | دریافت فرمت غیر جیسون |
| 11 | عملیات با موفقیت انجام نشد |
| 461 | وارد کردن دست کم نام یا نام خانوادگی در ورودی لازم است |
کد خطاهای پروایدر
| result.statusCode | |
| کد خطا | توضیح |
| 200 | بدون خطا |
| 201 | بدون خطا |
| 204 | بدون خطا |
| 400 | خطا در پارامترهای ورودی |
| 403 | سرور درخواست را درک می کند اما آن را تأیید نمی کند |
| 404 | پیدا نشد، درخواست نامعتبر، اشتباه در نام سرویس |
| 405 | منبع از این متد پشتیبانی نمی کند |
| 410 | منبع دیگر در سرور در دسترس نیست |
| 500 | خطای داخلی سرور |
| 502 | خطا در دریافت در درگاه سرور از سرور بالا دست |
| 503 | سرور آماده سرویس دهی نیست |
