مستندات
پیش از شروع، پیشنیازهایی برای ارتباط با سرور وجود دارد. قبل از هر کاری توسعهدهنده موظف است در واژهیاب عضو شود و از طریق پنل کاربری اقدام به دریافت توکن نماید. توکن، یک رشتهٔ منحصر به فرد است که به توسعهدهنده اختصاص داده میشود و از این طریق احراز هویت او در هر بار ارتباط با سرور انجام میگردد. این رشته، محرمانه بوده و توسعهدهنده باید برای تأمین امنیت اشتراک خود در حفظ آن کوشا باشد. بدیهی است امکان تولید دوبارهٔ توکن از طریق پنل کاربری فراهم خواهد بود.
ساختار URL
ساختار URL برای ارتباط به سرور بهطور کلی به شکل زیر است.
پارامترها
سرور از REST پشتیبانی میکند و پارامترهای ورودی بصورت Query String و پاسخ خروجی، json میباشد. همچنین در هر درخواست، علاوهبر پارامترهای مختص آن متد، لازم است پارامترهای زیر نیز وجود داشته باشند:
- token رشتهای است که برای احراز هویت توسعهدهنده استفاده میشود.
- ip برای پیگیریهای آتی، بهتر است تا آدرس IP کاربران سرویس خود در این پارامتر درج شود. این پارامتر اختیاری است.
- product نام محصولی که از api استفاده میکند در این پارامتر درج میشود. در این صورت میتوان در آینده آماری از درخواستها بر اساس نام محصول در اختیار داشت.
- prettyprint با true کردن این پارامتر، پاسخ خروجی، اصطلاحاً pretty printed خواهد بود. این مقدار بصورت پیشفرض true است.
- debug با true بودن این پارامتر، اطلاعاتی برای debug در اختیار توسعهدهنده قرار خواهد گرفت.
کدهای پاسخ
در Header پاسخ، یکی از کدهای زیر بازگشت داده میشود.
کد | توضیحات |
---|---|
۲۰۰ | سرور با موفقیت واژه را جستوجو کرده است. |
۴۰۰ | سرور قادر به تشخیص پارامترهای ورودی نیست. پارامترهای اجباری یافت نشدهاند. |
۴۰۱ | توسعهدهنده توسط سرور قادر به شناسایی نیست. |
۴۰۳ | سرور بنا به دلایل مشخص مانع دسترسی توسعهدهنده شده است. |
۴۰۴ | عبارت درخواست شده یافت نشد. |
۴۰۵ | متد مجاز نیست. |
۵۰۰ | سرور با خطا مواجه شده و قادر به انجام درخواست نمیباشد. |
۵۰۳ | سرور در حال حاضر در دسترس نمیباشد. |
دیتابیسها
دیتابیسهای موجود در واژهیاب به شرح زیر است.
نام | توضیحات |
---|---|
dehkhoda | لغتنامهٔ دهخدا |
moein | فرهنگ فارسی معین |
amid | فرهنگ فارسی عمید |
motaradef | واژگان مترادف و متضاد |
farhangestan | فرهنگ واژههای مصوّب فرهنگستان |
sareh | واژههای فارسی سره |
ganjvajeh | فرهنگ گنجواژه |
wiki | واژهنامهٔ آزاد |
slang | اصطلاحات عامیانه |
quran | فرهنگ واژگان قرآن |
name | فرهنگ نامها |
thesis | فرهنگ لغات علمی |
isfahani | لهجه و گویش اصفهانی |
bakhtiari | لهجه و گویش بختیاری |
tehrani | لهجه و گویش تهرانی |
dezfuli | لهجه و گویش دزفولی |
gonabadi | لهجه و گویش گنابادی |
mazani | لهجه و گویش مازنی |
en2fa | دیکشنری انگلیسی به فارسی |
ar2fa | دیکشنری عربی به فارسی |
fa2en | دیکشنری فارسی به انگلیسی |
fa2ar | دیکشنری فارسی به عربی |
جستوجوی واژه search
برای جستوجوی یک واژه و یا عبارت از این متد استفاده میشود. معنی واژه محدود شده و در انتهای آن «...» درج میشود.
پارامترها
- q واژه و یا عبارتی است که میخواهید جستوجو کنید.
- type نوع جستوجو را مشخص میکند. مقدار exact برای جستوجوی دقیق، ava برای جستوجوی همآوا، like برای جستوجوی مشابه و text برای جستوجو در معنی واژه استفاده میشود.
- start مشخص میکند که از چه ردیفی جستوجو آغاز گردد. این پارامتر بصورت پیشفرض ۰ است.
- rows تعداد ردیفها برای جستوجو. این پارامتر بصورت پیشفرض ۱۰ است و حداکثر مقدار آن ۵۰ میباشد.
- filter مشخص میکند که جستوجو در چه لغتنامههایی و با چه اولویتی انجام شود.
پاسخ
چند مثال
دریافت معنی واژه word
برای دریافت معنی کامل یک واژه از این متد استفاده میشود. این امکان وجود دارد که در معنی واژه کدهای HTML وجود داشته باشد.
پارامترها
- title واژهای که از متد search استخراج شدهاست.
- db نام دیتابیس که از متد search استخراج شدهاست.
- num پارامتر num که از متد search استخراج شدهاست.
پاسخ
چند مثال
پیشنهاد واژه suggest
لیست پیشنهادی برای استفاده در auto complete از این متد دریافت میشود.
پارامترها
- q واژه و یا یک عبارت