写真の取得

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（フィールド「name」）は、「Authorization 」ヘッダに追加する必要があるトークンによって保護されています。
このトークンは、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'