سرویس آوا
وب‌سرویس «آوا» کامل‌ترین جویشگر صوتی ایران و کشورهای فارسی زبان است. این وب‌سرویس با پوشش انبوهی از فایل‌های صوتی قادر است در کمترین زمان، آهنگ مورد نظر را در اختیار کاربر قرار دهد بی‌آنکه جستجوکننده درگیر صفحات و تبلیغات مزاحم شود. وب‌سرویس آوا با خزش ۲ میلیون فایل صوتی، روی موتور جستجوی بومی پارسی‌جو قابل دسترسی است. نتایج جستجوی آوا به صورت خودکار، بدون دخالت نیروی انسانی و توسط یک جستجوگر هوشمند صوتی از وب مجاز فارسی استخراج شده است. با گستردگی دنیای وب به نظر می‌رسد که برای یافتن و یا دانلود موسیقی و فایل صوتی چندان کار دشواری پیش رو نیست اما هرگاه که کاربر برای یافتن موزیک مورد نظر خود تلاش می‌کند با انبوهی از نتایج نامرتبط و سایت‌های تبلیغاتی روبه‌رو می‌شود که زمان و انرژی زیادی می‌گیرد به همین دلیل تلاش شده با خزش‌های هوشمند، این نقص در وب‌سرویس آوا به صفر برسد.
جستجو در آوا
با استفاده از متد جستجو در آوا شما می‌توانید نام آهنگ یا خواننده را به عنوان پارامتر ورودی وارد کنید و آهنگ مورد نظر را به همراه جزئیات کامل آن به عنوان خروجی دریافت کنید.
ساختار 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
پارامترهای خروجی:
-
عنوان اثرStringtitle
-
نام هنرمندStringartist
-
آدرس عکس هنرمندStringartistAvatar
-
آدرس اثرStringurl
-
کیفیتUnixTimeStringbitRate
-
حجمStringsize
-
زمان سرچStringsearchTime
-
تعداد کل نتایجStringresultNumber
یاداشت
- در صورت عدم ارسال پارامتر 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"
}
کپی در حافظه