Cluster Controller

Detail Description

아래내용은 샘플 내용 입니다.

URL

GET /cardinal

Path Parameters

id

string

(Required)

The unique identifier for the song.

storefront

string

(Required)

An iTunes Store territory, specified by an ISO 3166 alpha-2 country code. The possible values are the id attributes of Storefrontobjects.

Query Parameters

l

string

The localization to use, specified by a language tag. The possible values are in the supportedLanguageTags array belonging to the Storefrontobject specified by storefront. Otherwise, the storefront’s defaultLanguageTag is used.

include

[string]

Additional relationships to include in the fetch.

Response Codes

200SongResponse

OK

The request was successful.

Content-Type: application/json

`Discussion`

If successful, the HTTP status code is 200 (OK) and the data array in the ResponseRoot object contains a single Song object. If unsuccessful, the HTTP status code indicates the error and the details are in the errors array. See Handle a Response.

Example

Request

https://api.music.apple.com/v1/catalog/us/songs/900032829

Response

{
    "data": [
        {
            "attributes": {
                "albumName": "Something For the Pain",
                "artistName": "Michael de Jong",
                "artwork": {
                    "bgColor": "346687",
                    "height": 2400,
                    "textColor1": "c9fcf0",
                    "textColor2": "b4fbf3",
                    "textColor3": "abdedb",
                    "textColor4": "9bdddd",
                    "url": "https://example.mzstatic.com/image/thumb/Music3/v4/8d/5f/4e/8d5f4e8f-d677-ba24-15f0-f8035047a4cc/source/{w}x{h}bb.jpeg",
                    "width": 2400
                },
                "composerName": "Michael de Jong",
                "discNumber": 1,
                "durationInMillis": 327693,
                "genreNames": [
                    "Singer/Songwriter",
                    "Music",
                    "Blues"
                ],
                "isrc": "NLH851300057",
                "name": "Something For the Pain",
                "playParams": {
                    "id": "900032829",
                    "kind": "song"
                },
                "previews": [
                    {
                        "url": "https://example.itunes.apple.com/apple-assets-us-std-000001/Music3/v4/0e/87/8d/0e878d76-734f-39b3-8904-00c1fa873088/mzaf_8986718721308175601.plus.aac.p.m4a"
                    }
                ],
                "releaseDate": "2014-07-11",
                "trackNumber": 7,
                "url": "https://itunes.apple.com/us/album/something-for-the-pain/900032785?i=900032829"
            },
            "href": "/v1/catalog/us/songs/900032829",
            "id": "900032829",
            "relationships": {
                "albums": {
                    "data": [
                        {
                            "href": "/v1/catalog/us/albums/900032785",
                            "id": "900032785",
                            "type": "albums"
                        }
                    ],
                    "href": "/v1/catalog/us/songs/900032829/albums"
                },
                "artists": {
                    "data": [
                        {
                            "href": "/v1/catalog/us/artists/6671250",
                            "id": "6671250",
                            "type": "artists"
                        }
                    ],
                    "href": "/v1/catalog/us/songs/900032829/artists"
                }
            },
            "type": "songs"
        }
    ]
}