본문으로 건너뛰기

사진 검색하기

retrieve image

사진 검색은 데이터 피드 또는 API를 통해 전송된 URL을 사용하여 수행됩니다.

중요 참고 사항:

  • 이미지 관련 메타데이터 전송은 필수이며 두 가지를 함께 저장해야 합니다.
  • 이미지는 만료일이 있는 캐시에 저장해야 합니다.
  • 이 날짜가 만료되면 이미지를 검색하기 위해 새로운 API 호출을 수행해야 합니다.

API 호출 결과 예시:

엔드포인트의 일부 결과 "/api/artist/id/picture"

{
"id_picture": 4615,
"name": "https://images.music-story.com/protected/pictures/3b9e2e50-259a-11e7-b2c4-20eb3c695984/57309f32-259a-11e7-b2c4-20eb3c695984.jpg",
"source": "Getty",
"width": 3368,
"height": 3368
}

데이터 피드를 사용한 결과의 예:

아티스트 레벨의 json 파일의 일부 결과

{
"pictures" : [
{
"name": "https://images.music-story.com/protected/pictures/4dc2f342-fcda-11e6-afe3-1437daa09300/877df23f-fcda-11e6-afe3-1437daa09300.jpg"
"tags": null,
"metas": {
"id": 85351057,
"title": "Photo of Gram PARSONS",
"artist": "Jim McCrary"
}
}
]
}
  • 두 경우(API 또는 데이터 피드) 모두 이미지 URL(‘이름’ 필드)은 ‘인증’ 헤더에 추가해야 하는 토큰으로 보호됩니다.
  • 이 토큰은 API를 통해 메타데이터를 검색하는 데 사용되는 것과 동일한 토큰이며 메타데이터 모니터에서 사용할 수 있습니다: API > 모니터링.

cURL 명령어로 이미지를 검색하는 호출 예시*

curl -O 'https://images.music-story.com/protected/pictures/3b9e2e50-259a-11e7-b2c4-20eb3c695984/57309f32-259a-11e7-b2c4-20eb3c695984.jpg' \
-H 'Authorization: Bearer XXXXXX'