プレイバックAPI

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

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

HTTPリクエスト

GET https://ovp-p-api.smartstream.ne.jp/v1/merchants/:merchant_id/medias/:media_id

GET https://ovp-p-api.smartstream.ne.jp/v1/merchants/:merchant_id/medias/ref:ref_id

リクエストヘッダー

リクエストヘッダーはこちらをご確認ください。

URLパラメータ

フィールド	タイプ	説明	サンプル	必要性
media_id	String	メディアID	*****	media_id, ref_idのいずれか必須
merchant_id	String	マーチャントID	nttsmc	必須
ec_url	UrlString	エンタイトルメントチェックURL	https://…	任意
ref_id	String	参照ID	video1
user_id	String	ユーザーID	1	任意

レスポンス

フィールド	タイプ	説明
merchant_id	String	マーチャントID
id	String	メディアID
ref_id	String	参照ID (マーチャント内部でユニークである必要がある)
name	String	名前
description	Text	説明文
duration	Number	尺(milliseconds)
encode_type	String	エンコードタイプ (ファイル or ライブ or スケジュールライブ)
publish_status	String	公開設定
custom_fields	Object	カスタムフィールドの値、デフォルト値は{}
publish_geo_rule	String	公開地域ルール
poster	Object	ポスター画像
src	String	ポスター画像のURL
thumbnaill	Object	サムネイル画像
src	String	サムネイルのURL
seek_preview_config	JSON	シークプレビュー設定
tags	String[]	タグの配列
offline_enabled	Boolean	オフライン再生が可能か
sources	Object[]	動画ソースの配列
text_tracks	Object[]	テキストデータの配列
created_at	DateString	作成日時
updated_at	DateString	更新日時

レスポンスの例

{
  "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
}

エラーコード

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