با استفاده از این وب سرویس، میتوانید دسترسی کامل به سایت رادیو جوان داشته باشید. از قابلیت هایی که این وب سرویس در اختیار شما قرار میدهد، دریافت لینک دانلود آهنگ ها، ویدیوها و پادکست ها میباشد. همچنین میتوانید اطلاعات آلبوم و پلی لیست ها را دریافت کنید.

جهت خرید و دریافت توکن دسترسی، اینجا کلیک کنید. - نمونه توکن دسترسی: 926644:ad27e02513bee0ff57137a0618c6839e


دسترسی به نسخه 3 وب سرویس، از طریق لینک زیر امکان پذیر است:

https://api.ineo-team.ir/radiojavan.php

با توجه به اشتراکی بودن این وب سرویس، میبایست در هنگام ارسال درخواست از طریق متد GET، پارامتر auth را با مقدار توکن دسترسی خود ارسال کنید:

https://api.ineo-team.ir/radiojavan.php?auth=926644:ad27e02513bee0ff57137a0618c6839e

برای استفاده از این وب سرویس، درخواست ها را باید از طریق متد GET ارسال کنیم.

نکته مهم 1: این وب سرویس دارای سیستم کنترل اسپم میباشد و در صورتی که در 13 ثانیه، بیشتر از 11 درخواست به وب سرویس ارسال کنید، آیپی شما مسدود خواهد شد و دسترسی به این وب سرویس برای شما ممکن نخواهد بود و با توجه به قوانین و شرایط استفاده از وب سرویس های آی نئو، بعد از بلاک شدن، توکن دسترسی شما مسدود خواهد شد.

نکته مهم 2: در صورتی که از کانال رسمی وب سرویس های آی نئو خارج شوید، تمامی توکن دسترسی های شما غیرفعال میشوند و برای فعال سازی مجدد، میبایست ابتدا در کانال @iNeoAPI عضو شوید و بر روی دستور /active کلیک کنید تا توسط پشتیبانی، عضویت شما بررسی و توکن دسترسی های شما مجددا فعال شوند.




دریافت آیدی عددی مدیا:

ارسال درخواست از طریق متد GET: GET

با استفاده از این درخواست، میتوانید آیدی عددی مدیا مورد نظر (music, video, podcast) را از طریق لینک آنها دریافت کنید. سعی کنید اصلی را مانند نمونه به وب سرویس ارسال کنید و از لینک های اشتراکی (لینک کوتاه شده) رادیو جوان استفاده نکنید. در بخش result در نمونه پاسخ Json، مقدار type برابر با نوع پست مورد نظر شما میباشد که میتواند یکی از 3 نوع music، video و یا podcast باشد.

پارامتر
اهمیت
توضیحات
auth اجباری توکن دسترسی وب سرویس
action اجباری مقدار: idfinder
link اجباری لینک مدیا مورد نظر

نمونه ارسال درخواست از طریق لینک:

https://api.ineo-team.ir/radiojavan.php?auth=926644:ad27e0***18c6839e&action=idfinder&link=https://www.radiojavan.com/mp3s/mp3/Nassim-Mojeze-(Ft-Pishro)




دریافت اطلاعات و دانلود مدیا:

ارسال درخواست از طریق متد GET: GET

با استفاده از این درخواست، میتوانید با استفاده از آیدی عدد مدیا مورد نظر (music, video, podcast)، اطلاعات آن از جمله متن و لینک دانلود با چندین کیفیت را دریافت کنید. مقدار پارامتر action باید برابر با یکی از 3 نوع مدیا music، video و یا podcast باشد. در مثال زیر، درخواستی جهت دریافت اطلاعات یک music به وب سرویس ارسال میکنیم.

پارامتر
اهمیت
توضیحات
auth اجباری توکن دسترسی وب سرویس
action اجباری مقدار: music/video/podcast
id اجباری آیدی عددی مدیا مورد نظر

نمونه ارسال درخواست از طریق لینک:

https://api.ineo-team.ir/radiojavan.php?auth=926644:ad27e0***18c6839e&action=music&id=103974




دریافت اطلاعات و لینک مدیا آلبوم:

ارسال درخواست از طریق متد GET: GET

با استفاده از این درخواست، میتوانید اطلاعات و لینک مدیاهای آلبوم مورد نظر را دریافت کنید. دقت داشته باشید که باید نام آرتیست و نام آلبوم را با هم به وب سرویس معرفی کنید. برای مثال نام آرتیست jarshaa و نام آلبوم tapoori میباشد، پس میبایست مقدار پارامتر query را به صورت jarshaa-tapoori به وب سرویس ارسال کنید.

پارامتر
اهمیت
توضیحات
auth اجباری توکن دسترسی وب سرویس
action اجباری مقدار: album
query اجباری نام آرتیست و آلبوم، مقدار: jarshaa-tapoori

نمونه ارسال درخواست از طریق لینک:

https://api.ineo-team.ir/radiojavan.php?auth=926644:ad27e0***18c6839e&action=album&query=jarshaa-tapoori




دریافت اطلاعات و لینک مدیاهای آرتیست:

ارسال درخواست از طریق متد GET: GET

با استفاده از این درخواست، میتوانید اطلاعات و لینک مدیاهای یک آرتیست را دریافت کنید. این درخواست، در واقع همان قابلیت search یا جستجو در رادیو جوان میباشد. برای استفاده از این درخواست، باید مقدار پارامتر type برابر با music یا video باشد و مقدار پارامتر query باید برابر با نام آرتیست باشد.

پارامتر
اهمیت
توضیحات
auth اجباری توکن دسترسی وب سرویس
action اجباری مقدار: search
type اجباری نوع مدیا مورد نظر، مقدار: music/video
query اجباری نام آرتیست مورد نظر، مقدار: pishro

نمونه ارسال درخواست از طریق لینک:

https://api.ineo-team.ir/radiojavan.php?auth=926644:ad27e0***18c6839e&action=search&type=music&query=Pishro




دریافت اطلاعات پروفایل آرتیست:

ارسال درخواست از طریق متد GET: GET

با استفاده از این درخواست، میتوانید اطلاعات پروفایل یک آرتیست را دریافت کنید. دقت داشته باشید که نام آرتیست را باید همان طور که در رادیو جوان نوشته شده است، به پارامتر name ارسال کنید.

پارامتر
اهمیت
توضیحات
auth اجباری توکن دسترسی وب سرویس
action اجباری مقدار: artist
name اجباری نام آرتیست مورد نظر، مقدار: pishro

نمونه ارسال درخواست از طریق لینک:

https://api.ineo-team.ir/radiojavan.php?auth=926644:ad27e0***18c6839e&action=artist&name=pishro




دریافت لیست جدیدترین ها:

ارسال درخواست از طریق متد GET: GET

با استفاده از این درخواست، میتوانید جدیدترین پست های رادیو جوان را دریافت کنید. برای دریافت لیست جدیدترین ها، کافیست مقدار پارامتر action برابر با new و مقدار پارامتر type باید یکی از مقدار های music، video، podcast و یا album باشد.

پارامتر
اهمیت
توضیحات
auth اجباری توکن دسترسی وب سرویس
action اجباری مقدار: new
type اجباری نوع مدیا مورد نظر، مقدار: music/video/podcast/album

نمونه ارسال درخواست از طریق لینک:

https://api.ineo-team.ir/radiojavan.php?auth=926644:ad27e0***18c6839e&action=new&type=music




دریافت لیست جدیدترین پلی لیست ها و دسته بندی ها:

ارسال درخواست از طریق متد GET: GET

با استفاده از این درخواست، میتوانید لیست جدیدترین پلی لیست ها و دسته بندی پلی لیست ها را دریافت کنید.

پارامتر
اهمیت
توضیحات
auth اجباری توکن دسترسی وب سرویس
action اجباری مقدار: playlists

نمونه ارسال درخواست از طریق لینک:

https://api.ineo-team.ir/radiojavan.php?auth=926644:ad27e0***18c6839e&action=playlists




دریافت اطلاعات یک پلی لیست:

ارسال درخواست از طریق متد GET: GET

با استفاده از این درخواست، میتوانید اطلاعات یک پلی لیست را دریافت کنید. کافیست سریال یا آیدی پلی لیست مورد نظر خود را به پارامتر id ارسال کنید.

پارامتر
اهمیت
توضیحات
auth اجباری توکن دسترسی وب سرویس
action اجباری مقدار: playlist
id اجباری آیدی پلی لیست مورد نظر

نمونه ارسال درخواست از طریق لینک:

https://api.ineo-team.ir/radiojavan.php?auth=926644:ad27e0***18c6839e&action=playlist&id=777edf16182a




دریافت لیست پلی لیست های یک دسته بندی:

ارسال درخواست از طریق متد GET: GET

با استفاده از این درخواست، میتوانید لیست پلی لیست های یک دسته بندی را دریافت کنید. برای این کار، کافیست نام دسته بندی مورد نظر را به پارامتر name ارسال کنید.

پارامتر
اهمیت
توضیحات
auth اجباری توکن دسترسی وب سرویس
action اجباری مقدار: browseplaylist
name اجباری نام دسته بندی مورد نظر، مقدار: occasions

نمونه ارسال درخواست از طریق لینک:

https://api.ineo-team.ir/radiojavan.php?auth=926644:ad27e0***18c6839e&action=browseplaylist&name=occasions




جدول کد وضعیت درخواست ها:

با استفاده از جدول زیر، میتوانید وضعیت و خطا های هر درخواست وب سرویس رادیو جوان را بررسی کنید.


لیست کد وضعیت درخواست:

کد درخواست
توضیحات
200 - successfully درخواست به موفقیت ارسال شد.
4001 - parameter_error پارامترهای اصلی و اجباری وارد نشده اند.
7 - link_false لینک وارد شده اشتباه است.
9 - album_not_found آلبوم مورد نظر پیدا نشده است.

در صورتی که کد وضعیت مورد نظر، در جدول بالا نبود، جدول کامل لیست کد وضعیت درخواست ها را مطالعه کنید.




نمونه کد ارسال درخواست به زبان PHP:

ارسال درخواست از طریق متد GET با استفاده از cURL:

قطعه کد زیر، کد دسترسی کامل به وب سرویس رادیو جوان آی نئو تیم میباشد. کد زیر از طریق متد GET، درخواست های شما را به آدرس وب سرویس ارسال میکند. در کد زیر، شما باید مقدار پارامترها را به صورت آرایه به فانکشن مربوطه ارسال کنید. دقت داشته باشید که توکن دسترسی خود را حتما باید در خط 4 به جای YOUR-ACCESS-TOKEN بنویسید.

گیتهاب وب سرویس - معرفی در تلگرام - دانلود نمونه کد


تصویر زیر، قطعه کد ارسال درخواست میباشد که اطلاعات یک music با آیدی را نمایش میدهد.