ID로 여러 곡 조회하기
설명
곡의 고유 식별자를 사용하여 여러 곡을 동시에 가져오는 기능을 제공합니다.
Web Service Endpoint
HTTP 메소드 : GET
엔드포인트 :
https://api.music.apple.com/v1/catalog/{storefront}/songs
- 요청 예시
- 응답 형식
GET https://api.music.apple.com/v1/catalog/us/songs?ids=1613600188
Authorization: Bearer {developer_token}
{
"data": [
{
"id": "1613600188",
"type": "songs",
"href": "/v1/catalog/us/songs/1613600188",
"attributes": {
"albumName": "Emotional Creature",
"genreNames": [
"Alternative",
"Music"
],
"trackNumber": 1,
"durationInMillis": 221000,
"releaseDate": "2022-06-09",
"isrc": "USQE92100257",
"artwork": {
"width": 3000,
"height": 3000,
"url": "https://is1-ssl.mzstatic.com/image/thumb/Music112/v4/df/4e/68/df4e6833-9828-51d7-cdeb-71ecf6d3a23d/810090090962.png/{w}x{h}bb.jpg",
"bgColor": "202020",
"textColor1": "aea6f6",
"textColor2": "b68ef6",
"textColor3": "918bcb",
"textColor4": "9878cb"
},
"composerName": "Anthony Vaccaro, Jon Alvarado, Lili Trifilio & Matt Henkels",
"playParams": {
"id": "1613600188",
"kind": "song"
},
"url": "https://music.apple.com/us/album/entropy/1613600183?i=1613600188",
"discNumber": 1,
"hasLyrics": true,
"isAppleDigitalMaster": true,
"name": "Entropy",
"previews": [
{
"url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview122/v4/72/a3/ab/72a3ab79-0066-f773-6618-7a53adc250b3/mzaf_17921540907592750976.plus.aac.p.m4a"
}
],
"artistName": "Beach Bunny"
},
"relationships": {
"albums": {
"href": "/v1/catalog/us/songs/1613600188/albums",
"data": [
{
"id": "1613600183",
"type": "albums",
"href": "/v1/catalog/us/albums/1613600183"
}
]
},
"artists": {
"href": "/v1/catalog/us/songs/1613600188/artists",
"data": [
{
"id": "1147783278",
"type": "artists",
"href": "/v1/catalog/us/artists/1147783278"
}
]
}
}
}
]
}
Path Parameters
매개변수 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
storefront | String | Required | iTunes Store의 국가 또는 지역 코드입니다. (ISO 3166 alpha-2 형식). 가능한 값은 Storefront 객체의 id 속성에서 확인할 수 있습니다. |
Query Parameters
매개변수 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
ids | String[] | Required | 조회할 곡들의 고유 식별자입니다. 최대 300개의 곡을 조회할 수 있습니다. |
l | String | Optional | 사용할 언어를 지정하는 언어 태그입니다. 기본값은 해당 Storefront 객체의 defaultLanguageTag 입니다. |
include | String[] | Optional | 추가적으로 가져올 관계(Relationships)를 지정합니다. |
extend | String[] | Optional | 응답에서 리소스에 적용할 속성 확장 목록입니다. |
Response Codes
-
200 OK
:
요청이 성공적으로 처리되었으며,SongsResponse
객체가 반환됩니다. -
401 Unauthorized
:
올바르지 않은 Authorization 헤더가 사용되었음을 나타 내는 응답입니다. -
500 Internal Server Error
:
서버에서 오류가 발생했음을 나타내는 응답입니다.