مستندات وب سرویس ساندکلود

معرفی

این API امکان دریافت اطلاعات ترک‌های ساندکلود و لینک دانلود آن‌ها را فراهم می‌کند. این API دو روش برای دریافت اطلاعات ارائه می‌دهد: با استفاده از URL ترک و با استفاده از ID ترک.

نحوه استفاده

GET

دریافت اطلاعات با URL

http://mydomain/_apiSoundCloud.php?token={token}&url={url}

این درخواست اطلاعات مربوط به یک ترک ساندکلود را با استفاده از URL آن برمی‌گرداند.

پارامترها

نام	نوع	توضیحات
url	رشته	آدرس کامل ترک در ساندکلود (اجباری)
token	رشته	کلید اختصاصی هر فرد که موقع خرید به کاربر تحویل داده می شود

مثال

                    http://mydomain/_apiSoundCloud.php?token=token123456&url=https://soundcloud.com/user-551524139/cakal-riv-riv-riv
                

GET

دریافت اطلاعات با ID

http://mydomain/_apiSoundCloud.php?token={token}&id={id}

این درخواست اطلاعات مربوط به یک ترک ساندکلود را با استفاده از ID آن برمی‌گرداند.

پارامترها

نام	نوع	توضیحات
id	عدد	شناسه ترک در ساندکلود (اجباری)
token	رشته	کلید اختصاصی هر فرد که موقع خرید به کاربر تحویل داده می شود

مثال

http://mydomain/_apiSoundCloud.php?token=token123456&id=1114581718

نمونه پاسخ

پاسخ API به صورت JSON و با ساختار زیر بازگردانده می‌شود:

                {
                    "status": 200,
                    "message": "Successful",
                    "data": {
                        "size": "1.86 MB",
                        "favorite": "0",
                        "comment": "13",
                        "title": "Cakal - Riv Riv Riv",
                        "id": 1114581718,
                        "artwork_url": "https:\/\/mydomain\/sc.jpg",
                        "avatar_url": "https:\/\/i1.sndcdn.com\/avatars-OKLCBAKM6sxn5kIm-FxnY9Q-t500x500.jpg",
                        "created_at": "2021-08-28T14:41:43Z",
                        "username": "\u0130t Gece Havlar",
                        "dl": "https:\/\/cf-media.sndcdn.com\/2eX2Q6UPab4x.128.mp3?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiKjovL2NmLW1lZGlhLnNuZGNkbi5jb20vMmVYMlE2VVBhYjR4LjEyOC5tcDMqIiwiQ29uZGl0aW9uIjp7IkRhdGVMZXNzVGhhbiI6eyJBV1M6RXBvY2hUaW1lIjoxNzYwMzk3MDMzfX19XX0_&Signature=V~DSFFumoPfmo2Hm4PucdrDyuj79gD2KHnBvffBygBGJuqrIgTC1l4VM6uGSfvPVYJhwEgC6jN9Yxe~NfnwkFxUHGmg-QyqqbXIyTiDjPcNB0J8tPsPbZaCFJBYVHeIX6GbB86eV2G8lsI8JSpcTn1tRYVYGDZJk~8owbDYnycc9skrvQiXwpYblIhCYffV3Q1Z4rj5xrAnsn7XozJIBmXSeEA46cMRdBPCcOUckhMo-Uab8Maz2hiLSUqKWU-4WiwhbrpWYC62m2AxbE7jxSjcX6-gf8uxB14nGyNmCpMNeZn2liGlik6cJvQav-R8Ye1GIstRiPfR~CELlTdqEsQ__&Key-Pair-Id=APKAI6TU7MMXM5DG6EPQ",
                        "genre": "Hip-hop & Rap",
                        "allowupload": "yes"
                    }
                }
            

توضیحات فیلدها

رشته allowupload

نشان می‌دهد آیا آپلود مجاز است یا خیر (مقادیر: yes/no)

رشته size

حجم فایل صوتی

رشته favorite

تعداد علاقه‌مندی‌ها

رشته comment

تعداد نظرات

رشته title

عنوان ترک

عدد id

شناسه یکتای ترک در ساندکلود

رشته artwork_url

آدرس تصویر کاور ترک

رشته avatar_url

آدرس تصویر پروفایل کاربر

رشته created_at

تاریخ و زمان ایجاد ترک (فرت ISO 8601)

رشته username

نام کاربری صاحب ترک

رشته dl

لینک مستقیم دانلود فایل صوتی

رشته genre

سبک موسیقی

خطاها

در صورت بروز خطا، API پاسخ مناسب با کد وضعیت HTTP و پیام خطا بازمی‌گرداند. برخی از کدهای خطای رایج:

کد وضعیت	توضیحات
400	درخواست نامعتبر (پارامترهای ضروری ارسال نشده‌اند)
404	ترک مورد نظر یافت نشد
500	خطای سرور داخلی

توسعه‌دهنده

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

اطلاعات توسعه‌دهنده

نام: علی هستم 😎

تخصص:برنامه نویس و توسعه دهنده

گیت‌هاب

ALIILAPRO

تلگرام (پشتیبانی)

ALIILAPRO

پشتیبانی

برای گزارش مشکلات فنی، پیشنهادات یا سوالات در مورد API می‌توانید از طریق تلگرام با من در تماس باشید.

پاسخ‌گویی در ساعات نامعلوم😉
پشتیبانی از مشکلات فنی
دریافت پیشنهادات برای بهبود API
همکاری و پروژه‌های مشترک