写真の取得

写真の取得は、データフィードまたは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"
      }
      }
  ]
}

• いずれの場合でも、画像の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'