Spotify API Integration

async function getSpotifyToken(): Promise<string>

POST https://accounts.spotify.com/api/token

interface SpotifyToken {
  access_token: string;    // OAuth2 access token
  token_type: string;      // "Bearer"
  expires_in: number;      // Token lifetime in seconds
}

try {
  const token = await getSpotifyToken();
} catch (error) {
  // Throws: "Fallo en la autenticación de Spotify"
}

async function getArtistTopTracks(): Promise<Track[] | null>

interface Track {
  album: Album;                    // Album information
  artists: Artist2[];              // Array of artist objects
  available_markets: string[];     // ISO country codes
  disc_number: number;             // Disc number (multi-disc albums)
  duration_ms: number;             // Track duration in milliseconds
  explicit: boolean;               // Explicit content flag
  external_ids: ExternalIds;       // ISRC, EAN, UPC identifiers
  external_urls: ExternalUrls4;    // Spotify URL
  href: string;                    // API endpoint for full track info
  id: string;                      // Spotify track ID
  is_playable: boolean;            // Playback availability
  linked_from: LinkedFrom;         // Track linking information
  restrictions: Restrictions2;     // Playback restrictions
  name: string;                    // Track name
  popularity: number;              // 0-100 popularity score
  preview_url: string;             // 30-second preview MP3 URL
  track_number: number;            // Track position on album
  type: string;                    // "track"
  uri: string;                     // Spotify URI
  is_local: boolean;               // Local file flag
}

interface Album {
  album_type: string;              // "album" | "single" | "compilation"
  total_tracks: number;            // Number of tracks
  available_markets: string[];     // ISO country codes
  external_urls: ExternalUrls;     // Spotify URL
  href: string;                    // API endpoint
  id: string;                      // Spotify album ID
  images: Image[];                 // Album artwork (various sizes)
  name: string;                    // Album name
  release_date: string;            // YYYY-MM-DD format
  release_date_precision: string;  // "year" | "month" | "day"
  restrictions: Restrictions;      // Content restrictions
  type: string;                    // "album"
  uri: string;                     // Spotify URI
  artists: Artist[];               // Album artists
}

interface Image {
  url: string;                     // Image URL
  height: number;                  // Image height in pixels
  width: number;                   // Image width in pixels
}

interface Artist {
  external_urls: ExternalUrls2;    // Spotify URL
  href: string;                    // API endpoint
  id: string;                      // Spotify artist ID
  name: string;                    // Artist name
  type: string;                    // "artist"
  uri: string;                     // Spotify URI
}

GET https://api.spotify.com/v1/artists/{artist_id}/top-tracks?market=ES

import { getArtistTopTracks } from '@/server/services/spotify/tracks';

const tracks = await getArtistTopTracks();
if (tracks) {
  tracks.forEach(track => {
    console.log(`${track.name} - ${track.artists[0].name}`);
    console.log(`Popularity: ${track.popularity}`);
    console.log(`Duration: ${track.duration_ms}ms`);
  });
}

const tracks = await getArtistTopTracks();
if (!tracks) {
  console.error('Failed to retrieve tracks');
}