特定の映像の再生可能なURLを照会します。 プレイヤーを含むiframeを返す「映像iframe呼び出しAPI」とは異なり、このAPIは映像ソースへの直接リンクを提供します。
| 名前 | 必須/選択 | タイプ | 説明 | 備考 |
|---|---|---|---|---|
| Authorization | 必須 | string | API認証キー | |
| Authorization: Bearer your-api-key |
API認証キーは、[CMS > 基本設定 > リアルパッキングAPI管理]で作成したAPIキーです。 認証処理に問題を生じさせないためには、必ずAPIキーの前に「Bearer 」を追加しなければなりません。 | | Version | 必須 | string | API バージョン | Version: 2025-09-14
APIの利用に問題を生じさせないためには、正しいVersionを明示しなければなりません。 |
| 名前 | 必須/選択 | タイプ | 説明 | 備考 |
|---|---|---|---|---|
| videoCode | 必須 | string | 映像撮影コード |
<https://api.realpacking.com/v3/videos/videoCode12345/payback-url>
| 名前 | 必須/選択 | タイプ | 説明 | 備考 |
|---|---|---|---|---|
| generation-type | 選択 | string | 生成タイプ | generation-typeがリクエストに含まれない場合、リクエストされた映像撮影コード（videoCode）を持つすべての個別映像に対し、映像再生URLを返します。したがって、該当の映像撮影コードにN個の映像がある場合、N個の映像再生URLが提供されます。（N ≥ 1) |
generation-typeをリクエストに含める場合、値にはlatestのみが許可されます。
latest: リクエストされた映像撮影コード（videoCode）を持つ映像のうち、最も新しい映像1件に対する再生URLを1つ返します。 |
<https://api.realpacking.com/v3/videos/videoCode12345/playback-url?generation-type=latest>
No Request Body Required
| 名前 | 必須/選択 | タイプ | 説明 | 備考 |
|---|---|---|---|---|
| message | 必須 | string | http status message | |
| data | 必須 | map | 結果データ | |
| data.videoCode | 必須 | string | 映像撮影コード | |
| data.urlData | 必須 | map[] | 映像URLリスト | |
| data.urlData[i].url | 必須 | string | 映像URL | |
| data.urlData[i].videoId | 必須 | string | 映像固有ID | |
| data.urlData[i].recordedDate | 必須 | string | 映像撮影日時 | 形式: YYYY-MM-DDThh:mm:ss+00:00 (ISO8601) |