سرویس آوا

وب‌سرویس «آوا» کامل‌ترین جویشگر صوتی ایران و کشورهای فارسی زبان است. این وب‌سرویس با پوشش انبوهی از فایل‌های صوتی قادر است در کمترین زمان، آهنگ مورد نظر را در اختیار کاربر قرار دهد بی‌آنکه جستجوکننده درگیر صفحات و تبلیغات مزاحم شود. وب‌سرویس آوا با خزش ۲ میلیون فایل صوتی، روی موتور جستجوی بومی پارسی‌جو قابل دسترسی است. نتایج جستجوی آوا به صورت خودکار، بدون دخالت نیروی انسانی و توسط یک جستجوگر هوشمند صوتی از وب مجاز فارسی استخراج شده است. با گستردگی دنیای وب به نظر می‌رسد که برای یافتن و یا دانلود موسیقی و فایل صوتی چندان کار دشواری پیش رو نیست اما هرگاه که کاربر برای یافتن موزیک مورد نظر خود تلاش می‌کند با انبوهی از نتایج نامرتبط و سایت‌های تبلیغاتی روبه‌رو می‌شود که زمان و انرژی زیادی می‌گیرد به همین دلیل تلاش شده با خزش‌های هوشمند، این نقص در وب‌سرویس آوا به صفر برسد.

با استفاده از متد جستجو در آوا شما می‌توانید نام آهنگ یا خواننده را به عنوان پارامتر ورودی وارد کنید و آهنگ مورد نظر را به همراه جزئیات کامل آن به عنوان خروجی دریافت کنید.

ساختار URL

http(s)://developers.parsijoo.ir/web-service/v1/mp3/?type=search کپی در حافظه

در صورتی که api-key ندارید می توانید از این بخش ثبت نام کنید.

شناسایی و اعتبارسنجی حساب کاربری Authorization در سرویس‌های سفارشی پارسی‌جو توسط رشته api-key انجام می‌شود.

جهت اعتبارسنجی لازم است رشته api-key دریافت شده را در Header درخواست خود با پارامتر api-key قرار دهید.

فراخوانی متدها از طریق لایه SSL امکان‌پذیر است.

خطاهای مربوط به حساب کاربری:

429تعداد درخواست‌ها بیش از حد مجاز است.

403حساب کاربری معتبر نیست. این خطا در صورتی که کد شناسایی api-key اشتباه ارسال شود رخ می‌دهد.

متد GET,POST

پارامترهای ورودی:
  • پرس‌و‌جو
    متن مورد نظر در حالت POST یا GET حتما باید Encode شود
    String
    اجباری
    q
  • شماره صفحه
    Integer
    اختیاری
    page
  • تعداد نتایج در هر صفحه
    Integer
    اختیاری
    nrpp
پارامترهای خروجی:
  • عنوان اثر
    String
    title
  • نام هنرمند
    String
    artist
  • آدرس عکس هنرمند
    String
    artistAvatar
  • آدرس اثر
    String
    url
  • کیفیت
    UnixTime
    String
    bitRate
  • حجم
    String
    size
  • زمان سرچ
    String
    searchTime
  • تعداد کل نتایج
    String
    resultNumber

یاداشت

  • در صورت عدم ارسال پارامتر page، نتایج صفحه اول ارسال خواهد شد.

خطاهای مربوط به پاسخ درخواست:

400پارامترها ناقص هستند.

404متدی با این نام پیدا نشده است.

405متد فراخوانی Get یا Post اشتباه است.

500خطا در انجام عملیات، بعدا تلاش کنید.

مثال

https://developers.parsijoo.ir/web-service/v1/mp3/?q=%D8%B4%D8%AC%D8%B1%DB%8C%D8%A7%D9%86&type=search&page=4&nrpp=10 کپی در حافظه
{ "items":[ { "title":"تصنیف(ساقی)", "artist":"محمدرضا شجریان", "artistAvatar":"http://ava.parsijoo.ir/Thumbnail?id=2146655170", "urls":[ { "url":"http://dl.musickhor.ir/music/albume/1395/95.7/Mohammadreza%20Shajarian/Mohammadreza%20Shajarian%20-%20Tarighe%20Eshgh/09%20Tasnif%20(Saghi).mp3", "bitRate":"320", "size":"20MB" }, { "url":"http://dl.nex1music.ir/1395/07/05/Mohammadreza%20Shajarian%20-%20Tarighe%20Eshgh%20%5BAlbum%5D/Mohammadreza%20Shajarian%20-%20Tarighe%20Eshgh/09.%20Mohammadreza%20Shajarian%20-%20Tasnif%20(Saghi).mp3", "bitRate":"320", "size":"20.1MB" }, { "url":"http://dl.sarimusic.ir/1395/07/05/Mohammadreza%20Shajarian%20-%20Tarighe%20Eshgh/Mohammadreza%20Shajarian%20-%20Tarighe%20Eshgh/09%20Tasnif%20(Saghi).mp3", "bitRate":"320", "size":"20MB" }, { "url":"http://dl.best1music.ir/Music/Mohammadreza%20Shajarian/Tarighe%20Eshgh/Mohammadreza%20Shajarian%20-%20Tarighe%20Eshgh/09.%20Mohammadreza%20Shajarian%20-%20Tasnif%20(Saghi).mp3", "bitRate":"320", "size":"20.1MB" } ] } ], "searchTime":"0.081", "resultNumber":"2825" } کپی در حافظه
افزونه پارسی‌جو فایرفاکس

افزونه پارسی‌جو راهی برای استفاده از امکانات موتور جستجوی پارسی‌جو در مرورگر فایرفاکس

  • نمایش اطلاعات
    آب و هوایی شهر شما
  • نمایش تقویم شمسی
    به همراه ساعت
  • نمایش پربازدیدترین
    سایت‌ها
  • امکان ترجمه متون وب
    با انتخاب متن انتخابی
  • امکان تغییر شهر

برای نصب افزونه پارسی‌جو می‌توانید با کلیک بر روی آیکون مرورگر خود از طریق مرجع رسمی افزونه‌های مرورگر خود اقدام به نصب افزونه نمایید

نصب افزونه پارسی‌جو
افزونه پارسی‌جو گوگل کروم

افزونه پارسی‌جو راهی برای استفاده از امکانات موتور جستجوی پارسی‌جو در مرورگر گوگل کروم

  • نمایش اطلاعات
    آب و هوایی شهر شما
  • نمایش تقویم شمسی
    به همراه ساعت
  • نمایش پربازدیدترین
    سایت‌ها
  • امکان ترجمه متون وب
    با انتخاب متن انتخابی
  • امکان تغییر شهر

برای نصب افزونه پارسی‌جو می‌توانید با کلیک بر روی آیکون مرورگر خود از طریق مرجع رسمی افزونه‌های مرورگر خود اقدام به نصب افزونه نمایید

نصب افزونه پارسی‌جو
اپلیکیشن موبایل پارسی‌جو

با اپلیکیشن پارسی‌جو، یک جستجوگر همه‌کاره در جیب خود داشته باشید

  • جستجوی
    سریع و آسان
  • پوشش حداکثری
    صفحات وب فارسی
  • پشتیبانی از
    سرویس‌های پرکاربرد
  • رابط کاربری
    ساده و راحت
  • دسترسی راحت به
    مطالب و سرویس‌ها

رابط کاربری ساده و سرعت بالای اپلیکیشن پارسی‌جو به گونه‌ای است که به راحتی و در کمترین زمان ممکن قادرید جستجوی خود را انجام داده و به نتیجه صحیح می‌رسید.

صفحه خانگی

صفحه خانگی پارسی‌جو راهی برای دسترسی سریع به امکانات موتور جستجوی پارسی‌جو

  • 1
    بر روی نماد آچار یا منو در نوار ابزار مرورگر کلیک کنید (سمت راست بالا)
  • 2
    گزینه Options یا Preferences یا Settings را انتخاب نمایید.
  • 3
    گزینه Show Home Button را تیک بزنید و سپس Change را انتخاب کنید.
  • 4
    آدرس http://parsijoo.ir را در کادر وارد نمایید.

حال در هر لحظه می‌توانید با کلیک بر روی نماد خانه به پارسی‌جو منتقل شوید و جستجوی خود را آغاز کنید.

دریافت شناسه سرویس

شناسه کاربری شما برای استفاده از سرویس آوا پارسی‌جو آماده است!

همچنین می‌توانید لیست شناسه بقیه سرویس‌ها را از داشبورد خود مشاهده کنید.

دریافت شناسه سرویس

برای استفاده از سریس های سفارشی ابتدا باید به حساب کاربری خود وارد شوید.