GET /songs/{songId}

Vrací detail jedné skladby podle jejího ID. Přístup pro všechny přihlášené uživatele.

Path parameters

  • songId string Required

    Unikátní ID skladby

Responses

  • 200 application/json

    Detail skladby načten.

    Hide response attributes Show response attributes object
    • id
    • title string
    • duration integer
    • artistIds array[string]
    • genre string
  • 401 application/json

    Chyba autentizace

    Hide response attributes Show response attributes object
    • code string
    • message string
  • 403 application/json

    Nedostatečná oprávnění

    Hide response attributes Show response attributes object
    • code string
    • message string
  • 404 application/json

    Zdroj nenalezen

    Hide response attributes Show response attributes object
    • code string
    • message string
  • 500 application/json

    Chyba serveru

    Hide response attributes Show response attributes object
    • code string
    • message string
GET /songs/{songId}
curl \
 --request GET 'https://api.mstonjek.cz/v1/songs/song_123' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "id": "8d3f7e7a-6a6b-4b99-9b52-6f9d7d2a0a11",
  "title": "Losing It",
  "duration": 245,
  "artistIds": [
    "8d3f7e7a-6a6b-4b99-9b52-6f9d7d2a0a11"
  ],
  "genre": "Electronic"
}
Response examples (401)
{
  "code": "UNAUTHORIZED",
  "message": "Token není platný"
}
Response examples (403)
{
  "code": "FORBIDDEN",
  "message": "Nemáte oprávnění"
}
Response examples (404)
{
  "code": "NOT_FOUND",
  "message": "Zdroj uživatel 'user_123' nebyl nalezen."
}
Response examples (500)
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Server momentálně nedostupný"
}