プレイバックAPI

IDもしくは参照IDによるメディアの取得

メディアの情報をIDもしくは参照IDで取得するAPIです。

HTTPリクエスト
GET https://ovp-p-api.smartstream.ne.jp/v1/merchants/:merchant_id/medias/:media_id

OR

GET https://ovp-p-api.smartstream.ne.jp/v1/merchants/:merchant_id/medias/ref:ref_id
リクエストヘッダー

このAPIはマーチャント単位で認証の有無を設定することができます。
認証を必要とする場合、リクエストヘッダーに認証情報を設定してください。

フィールドタイプ説明
AuthorizationStringAuthorization: Bearer access_token
URLパラメータ
フィールドタイプ説明サンプル必要性
media_idStringメディアID*****media_id, ref_idのいずれか必須
merchant_idStringマーチャントIDnttsmc必須
ec_urlUrlStringエンタイトルメントチェックURLhttps://…任意
ref_idString参照IDvideo1
user_idStringユーザーID1任意
レスポンス
フィールドタイプ説明
merchant_idStringマーチャントID
idStringメディアID
ref_idString参照ID (マーチャント内部でユニークである必要がある)
nameString名前
descriptionText説明文
durationNumber尺(milliseconds)
encode_typeStringエンコードタイプ (ファイル or ライブ or スケジュールライブ
publish_statusString公開設定
custom_fieldsObjectカスタムフィールドの値、デフォルト値は{}
publish_geo_ruleString公開地域ルール
posterObjectポスター画像
 srcStringポスター画像のURL
thumbnaillObjectサムネイル画像
 srcStringサムネイルのURL
seek_preview_configJSONシークプレビュー設定
tagsString[]タグの配列
offline_enabledBooleanオフライン再生が可能か
sourcesObject[]動画ソースの配列
text_tracksObject[]テキストデータの配列
created_atDateString作成日時
updated_atDateString更新日時

レスポンスの例

{
"id": "40459b7e6e414652828f98af788f3abc",
"name": "BigBuckBunny",
"ref_id": null,
"description": null,
"thumbnail": {
   "src": "https://images.smartstream.jp/nttsmc/12345667890/1234567890.jpg"
},
"poster": {
   "src": "https://images.smartstream.jp/nttsmc/12345667890/9999999999.jpg"
},
"tags": [],
"encode_type": "",
"publish_status": "",
"custom_fields": {},
"merchant_id": "nttsmc",
"publish_geo_rule": null,
"sources": [
  {
    "type": "application/vnd.apple.mpegurl",
    "src": "https://ovp-vod.smartstream.jp/nttsmc/40459b7e6e414652828f98af788f3abc/11111111/playlist.m3u8",
    "label": "35f91a9919164562b3dbb109fc27def4",
    "key_systems": {
      "com.apple.fps.1_0": {
        "key_request_url": "https://bees.smartstream.jp/nttsmc/40459b7e6e414652828f98af788f3abc/fairplay-license/?token=129y94hqfihliufo98yh2l3oh12luglruahdoczhp8doi2hiu1g",
        "certificate_url": "https://bees.smartstream.jp/nttsmc/40459b7e6e414652828f98af788f3abc/fairplay-license/cert/?specConform=true&token=129y94hqfihliufo98yh2l3oh12luglruahdoczhp8doi2hiu1g"
      }
    },
    "id": "791f9297e1da4ada8afcec2bea0c3a31"
  },
  {
    "type": "application/dash+xml",
    "src": "https://ovp-vod.smartstream.jp/nttsmc/1/123567890/manifest.mpd",
    "label": "b5c8614dd18249b5830e3238a28ed71e",
    "key_systems": {
      "com.widevine.alpha": {
        "license_url": "https://bees.smartstream.jp/nttsmc/40459b7e6e414652828f98af788f3abc/cenc/?specConform=true&token=129y94hqfihliufo98yh2l3oh12luglruahdoczhp8doi2hiu1g"
      },
      "com.microsoft.playready": {
        "license_url": "https://bees.smartstream.jp/nttsmc/40459b7e6e414652828f98af788f3abc/RightsManager.asmx?token=129y94hqfihliufo98yh2l3oh12luglruahdoczhp8doi2hiu1g"
      }
    },
    "id": "bca76a9f43214294b5d6db7e5acce5c2"
  }
],
"duration": 3600000,
"text_tracks": [
  {
    "mime_type": "text/vtt",
    "default": false,
    "src": "https://assets.smartstream.jp/nttsmc/1234567890.vtt?mediaId=40459b7e6e414652828f98af788f3abc",
    "asset_id": "1111111111"
    "label": "ES",
    "id": "f696dc837e9a43f6b12e0f039bfb2f89",
    "kind": "captions",
    "lang": "es"
  }
],
"seek_preview_config": null,
"created_at": "2017-10-01T00:00:00.000Z",
"updated_at": "2017-10-01T00:00:00.000Z",
"offline_enabled": false
}

エラーコード
ステータスコードコードメッセージ
400BAD_REQUESTリクエストパラメーターが不正です
401UNAUTHORIZED認証に失敗しました
404MEDIA_NOT_FOUND該当するメディアが存在しません
500SERVER_ERROR予期せぬエラーが発生しました