با استفاده از این وب سرویس، میتوانید دسترسی کامل به سایت رادیو جوان داشته باشید. از قابلیت هایی که این وب سرویس در اختیار شما قرار میدهد، دریافت لینک دانلود آهنگ ها، ویدیوها و پادکست ها میباشد. همچنین میتوانید اطلاعات آلبوم و پلی لیست ها را دریافت کنید.
جهت خرید و دریافت توکن دسترسی، اینجا کلیک کنید. - نمونه توکن دسترسی: 926644:ad27e02513bee0ff57137a0618c6839e
دسترسی به نسخه 4 وب سرویس، از طریق لینک زیر امکان پذیر است:
https://api.ineo-team.ir/rj.php
با توجه به اشتراکی بودن این وب سرویس، میبایست در هنگام ارسال درخواست از طریق متد GET، پارامتر accessKey را با مقدار توکن دسترسی خود ارسال کنید:
https://api.ineo-team.ir/rj.php?accessKey=926644:ad27e02513bee0ff57137a0618c6839e
برای استفاده از این وب سرویس، درخواست ها را باید از طریق متد GET یا POST ارسال کنیم.
نکته مهم 1: این وب سرویس دارای سیستم کنترل اسپم میباشد و در صورتی که در 13 ثانیه، بیشتر از 11 درخواست به وب سرویس ارسال کنید، آیپی شما مسدود خواهد شد و دسترسی به این وب سرویس برای شما ممکن نخواهد بود و با توجه به قوانین و شرایط استفاده از وب سرویس های آی نئو، بعد از بلاک شدن، توکن دسترسی شما مسدود خواهد شد.
نکته مهم 2: در صورتی که از کانال رسمی وب سرویس های آی نئو خارج شوید، تمامی توکن دسترسی های شما غیرفعال میشوند و برای فعال سازی مجدد، میبایست ابتدا در کانال @iNeoAPI عضو شوید و بر روی دستور /active کلیک کنید تا توسط پشتیبانی، عضویت شما بررسی و توکن دسترسی های شما مجددا فعال شوند.
نکته مهم 3: با توجه به اطلاعیه بروز رسانی نسخه 4، نسخه جدید بر روی آدرس جدید ثبت شده است که اگر شخصی، قادر به ارائه بروز رسانی برای برنامه، ربات یا سایت خود نیست و نمیتواند از پارامترهای ورود و خروجی جدید استفاده کند، از نسخه قدیمی (v3) استفاده کند. نسخه قدیمی، بر روی آدرس فعلی باقی میماند.
دریافت آیدی عددی مدیا:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید آیدی عددی مدیا مورد نظر (music, video, podcast) را از طریق لینک آنها دریافت کنید. در بخش result در نمونه پاسخ Json، مقدار type برابر با نوع پست مورد نظر شما میباشد که میتواند یکی از مدیاهای music، video، podcast، album و یا playlist باشد.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: getid |
| link | اجباری | لینک مدیا مورد نظر |
نمونه ارسال درخواست از طریق لینک:
دریافت اطلاعات مدیا از طریق شناسه/ID:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید از طریق شناسه عددی یا ID مدیاهای music، video، podcast و یا album، اطلاعات و لینک های دانلود آن مدیا را به صورت کامل دریافت کنید.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: media |
| type | اجباری | مقدار: music, video, podcast, album |
| id | اجباری | شناسه عددی (ID) مدیا |
نمونه ارسال درخواست از طریق لینک:
https://api.ineo-team.ir/rj.php?accessKey=926644:ad27e0***18c6839e&action=media&type=music&id=80644
دریافت اطلاعات مدیاهای آرتیست:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید از طریق نام آرتیست، به لیست مدیاهای music، video، podcast و یا album آرتیست دسترسی داشته باشید و اطلاعات و لینک های دانلود آن مدیا را به صورت کامل دریافت کنید.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: media |
| type | اجباری | مقدار: music, video, podcast, album |
| artist | اجباری | نام آرتیست، مقدار: pishro |
نمونه ارسال درخواست از طریق لینک:
دریافت پادکست های آرتیست سازنده پادکست:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید لیست پادکست های دیگر یک آرتیست را مشاهده کنید.
نکته مهم: دقت داشته باشید این آرتیست، پادکست آرتیست (مانند: Khodcast) شناخته میشود و با آرتیست های خواننده (مانند: Pishro) تفاوت دارد.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: podcast |
| type | اجباری | مقدار: show |
| artist | اجباری | نام آرتیست، مقدار: khodcast |
نمونه ارسال درخواست از طریق لینک:
جستجو:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید ورودی مورد نظر خود را در سایت جستجو کنید. در خروجی این جستجو، به شما لیست کاملی از artist، music، video، podcast، album و playlist را به صورت دسته بندی شده نمایش میدهد که همگی از نتایج جستجو شما جمع شده اند.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: search |
| query | اجباری | مقدار: pishro |
نمونه ارسال درخواست از طریق لینک:
https://api.ineo-team.ir/rj.php?accessKey=926644:ad27e0***18c6839e&action=search&query=top
دریافت اطلاعات پروفایل آرتیست:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید اطلاعات پروفایل یک آرتیست را دریافت کنید.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: profile |
| artist | اجباری | نام آرتیست، مقدار: pishro |
نمونه ارسال درخواست از طریق لینک:
https://api.ineo-team.ir/rj.php?accessKey=926644:ad27e0***18c6839e&action=profile&artist=pishro
دریافت اطلاعات پلی لیست:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید اطلاعات و لیست آهنگ های یک پلی لیست را دریافت کنید.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: playlist |
| id | اجباری | شناسه پلی لیست، مقدار: 854b87855624 |
نمونه ارسال درخواست از طریق لینک:
https://api.ineo-team.ir/rj.php?accessKey=926644:ad27e0***18c6839e&action=playlist&id=854b87855624
دریافت لیست استوری ها:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید لیست تمامی استوری های آپلود شده را مشاهده کنید.
نکته مهم: دقت داشته باشید هر استوری نمایش داده شده در لیست، دارای یک hash میباشد که با استفاده از آن، میتوانید اطلاعات هر استوری را در درخواست بعدی دریافت کنید.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: stories |
نمونه ارسال درخواست از طریق لینک:
https://api.ineo-team.ir/rj.php?accessKey=926644:ad27e0***18c6839e&action=stories
دریافت اطلاعات یک استوری:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید از طریق hash ارائه شده در درخواست قبلی (دریافت لیست استوری ها)، اطلاعات و لینک های دانلود آن استوری را دریافت کنید.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: storie |
| hash | اجباری | مقدار: 4xkzXbbQ |
نمونه ارسال درخواست از طریق لینک:
https://api.ineo-team.ir/rj.php?accessKey=926644:ad27e0***18c6839e&action=storie&hash=4xkzXbbQ
دریافت اطلاعات آپلود کننده استوری:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید پروفایل آپلود کننده استوری را مشاهده کنید.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: storie_user |
| username | اجباری | مقدار: sba._.jd |
نمونه ارسال درخواست از طریق لینک:
دریافت اطلاعات یک آلبوم:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید اطلاعات و لیست آهنگ های یک آلبوم را دریافت کنید.
نکته مهم: دقت داشته باشید که برای دریافت اطلاعات آلبوم، باید شناسه عددی یکی از آهنگ های آلبوم را به پارامتر id ارسال کنید.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: media |
| id | اجباری | شناسه عددی یکی از آهنگ های آلبوم |
نمونه ارسال درخواست از طریق لینک:
https://api.ineo-team.ir/rj.php?accessKey=926644:ad27e0***18c6839e&action=media&type=album&id=6508
دریافت لیست جدیدترین ها:
ارسال درخواست از طریق متد GET: GET
با استفاده از این درخواست، میتوانید لیست جدیدترین/ترند شده ها را دریافت کنید. با این درخواست
شما میتوانید مدیاهای music، video، podcast، album و playlist را دریافت کنید.
| accessKey | اجباری | توکن دسترسی وب سرویس |
|---|---|---|
| action | اجباری | مقدار: new |
| type | اجباری | یکی از مقدار های ذکر شده |
نمونه ارسال درخواست از طریق لینک:
https://api.ineo-team.ir/rj.php?accessKey=926644:ad27e0***18c6839e&action=new&type=music
جدول کد وضعیت درخواست ها:
با استفاده از جدول زیر، میتوانید وضعیت و خطا های هر درخواست وب سرویس رادیو جوان را بررسی کنید.
لیست کد وضعیت درخواست:
| 200 - successfully | درخواست به موفقیت ارسال شد. |
|---|---|
| 4001 - parameter_error | پارامترهای اصلی و اجباری وارد نشده اند. |
| 7 - link_false | لینک وارد شده اشتباه است. |
| 404 - not_found | خروجی مورد نظر پیدا نشده است. |
در صورتی که کد وضعیت مورد نظر، در جدول بالا نبود، جدول کامل لیست کد وضعیت درخواست ها را مطالعه کنید.
نمونه کد ارسال درخواست به زبان PHP:
ارسال درخواست از طریق متد POST با استفاده از cURL:
قطعه کد زیر، کد دسترسی کامل به وب سرویس رادیو جوان آی نئو تیم میباشد. کد زیر از طریق متد POST، درخواست های شما را به آدرس وب سرویس ارسال میکند. در کد زیر، شما باید مقدار پارامترها را به صورت آرایه به فانکشن مربوطه ارسال کنید. دقت داشته باشید که توکن دسترسی خود را حتما باید به جای YOUR-ACCESS-TOKEN بنویسید.
گیتهاب وب سرویس - معرفی در تلگرام - اطلاعیه بروز رسانی (v4) - دانلود نمونه کد - تغییر نسخه
