دانلود از اسپاتیفای (ترک، آلبوم و پلی‌لیست)

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

مشخصات

مشخصه	مقدار
دسته‌بندی	دانلودر
وضعیت	فعال
نسخه API	apis-1
فرمت پاسخ	JSON
آدرس پایه	https://open.nestapi.ir
مسیر	/apis-1/spotify-download
لینک کامل	https://open.nestapi.ir/apis-1/spotify-download

متدهای HTTP

متد	مسیر	نوع ورودی
GET	/apis-1/spotify-download	Query String

پارامترها

پارامترهای Query String

نام	نوع	الزامی	پیش‌فرض	توضیحات
url	string	بله	—	لینک ترک، آلبوم، پلی‌لیست یا آرتیست اسپاتیفای (یا URI مثل spotify:track:...)

نمونه درخواست

لینک مستقیم

GET https://open.nestapi.ir/apis-1/spotify-download?url=https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-1/spotify-download?url=https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi();

try {
    $response = $api->spotifyDownload(
        url: 'https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M',
    );

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi() as api:
    try:
        response = api.spotify_download(
            url="https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
        )

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi();

try {
  const response = await api.spotifyDownload({
    url: "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
  });

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

کدهای خطا

کد	وضعیت	علت
NOT_FOUND	404	لینک پیدا نشد یا خصوصی است
PARAM_NOT_FOUND	400	پارامتر لازم ارسال نشده
VALIDATION_ERROR	422	پارامتر آمده ولی نوع، قالب یا بازه‌اش نادرست است
INVALID_URL	422	لینک ارسالی یک لینک معتبر اسپاتیفای نیست
INVALID_TOKEN	403	لینک دانلود نامعتبر، دستکاری‌شده یا منقضی است
TRACK_NOT_FOUND	404	ترک مورد نظر دیگر در دسترس نیست
RATE_LIMITED	429	تعداد درخواست‌های دانلود بیش از حد مجاز است؛ کمی بعد دوباره تلاش کنید
DOWNLOAD_FAILED	502	خطا در دانلود محتوا از سرور
SERVICE_UNAVAILABLE	502	خطا در ارتباط با سرویس بالادستی یا پاسخ نامعتبر از آن
UPSTREAM_CHANGED	502	ساختار سرویس مبدا تغییر کرده و قابل پردازش نیست
UPSTREAM_BLOCKED	503	سرویس مبدا موقتاً درخواست‌های سرور را مسدود کرده است
UPSTREAM_VERIFICATION_REQUIRED	503	سرویس مبدا موقتاً تأیید انسانی (کپچا) درخواست می‌کند
SERVICE_MAINTENANCE	503	سرویس مبدا در حال تعمیر و نگهداری است

لینک های بیشتر

• راهنمای اتصال به سرویس
• فرمت خروجی موفقیت API
• فرمت خروجی خطای API
• کدهای خطای عمومی