با استفاده از این وب سرویس، میتوانید دسترسی کامل به سایت رادیو جوان داشته باشید. از قابلیت هایی که این وب سرویس در اختیار شما قرار میدهد، دریافت لینک دانلود آهنگ ها، ویدیوها و پادکست ها میباشد. همچنین میتوانید اطلاعات آلبوم و پلی لیست ها را دریافت کنید.
جهت خرید و دریافت توکن دسترسی، اینجا کلیک کنید. - نمونه توکن دسترسی: 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 | اجباری | لینک مدیا مورد نظر |
نمونه ارسال درخواست از طریق لینک:
دریافت اطلاعات و دانلود مدیا:
ارسال درخواست از طریق متد 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 |
نمونه ارسال درخواست از طریق لینک:
جدول کد وضعیت درخواست ها:
با استفاده از جدول زیر، میتوانید وضعیت و خطا های هر درخواست وب سرویس رادیو جوان را بررسی کنید.
لیست کد وضعیت درخواست:
| 200 - successfully | درخواست به موفقیت ارسال شد. |
|---|---|
| 4001 - parameter_error | پارامترهای اصلی و اجباری وارد نشده اند. |
| 7 - link_false | لینک وارد شده اشتباه است. |
| 9 - album_not_found | آلبوم مورد نظر پیدا نشده است. |
در صورتی که کد وضعیت مورد نظر، در جدول بالا نبود، جدول کامل لیست کد وضعیت درخواست ها را مطالعه کنید.
نمونه کد ارسال درخواست به زبان PHP:
ارسال درخواست از طریق متد GET با استفاده از cURL:
قطعه کد زیر، کد دسترسی کامل به وب سرویس رادیو جوان آی نئو تیم میباشد. کد زیر از طریق متد GET، درخواست های شما را به آدرس وب سرویس ارسال میکند. در کد زیر، شما باید مقدار پارامترها را به صورت آرایه به فانکشن مربوطه ارسال کنید. دقت داشته باشید که توکن دسترسی خود را حتما باید در خط 4 به جای YOUR-ACCESS-TOKEN بنویسید.
گیتهاب وب سرویس - معرفی در تلگرام - دانلود نمونه کد - تغییر نسخه
تصویر زیر، قطعه کد ارسال درخواست میباشد که اطلاعات یک music با آیدی را نمایش میدهد.
