Skip to main content

Resource ID

Resource ID Description

A Resource ID is a unique identifier assigned to each entity within the API, such as an Artist, Album, or Track. It is used to uniquely reference a specific resource when making API requests.

1. Reccobeats ID

  • A hash-based UUID (Universally Unique Identifier) assigned internally by the Reccobeats system.
  • It follows the UUID v4 format, which consists of 32 hexadecimal characters separated by hyphens.
  • Used for internal referencing and database management within Reccobeats.
  • Example: 2670c328-c40f-45f4-80df-f48b29296deb

2. Spotify ID

  • A Base-62 encoded string used by Spotify to uniquely identify a resource.
  • Found at the end of the Spotify URL (Example: open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02)
  • Used for searching multiple resource.
  • Example: 06HL4z0CvFAxyc27GXpf02

Usage in API Requests

When interacting with API endpoints, both Reccobeats ID and Spotify ID may be used depending on the context.

  • Fetching a track detail by ID we must use ReccoBeats ID:

    GET /track/878dadea-33c5-4c08-bdb9-e2b117475a99
  • Retrieving multiple tracks by IDs supports both ReccoBeats IDs and Spotify IDs:

    GET /track?ids=00vJzaoxM3Eja1doBUhX0P&ids=2670c328-c40f-45f4-80df-f48b29296deb  
  • Get track recommendation supports both ReccoBeats IDs and Spotify IDs:

    GET /track/recommendation?seeds=00vJzaoxM3Eja1doBUhX0P&seeds=2670c328-c40f-45f4-80df-f48b29296deb&size=10