Transloadit
料金
  • ファイルアップロード
  • ファイルインポート
  • バッチ処理
  • 動画エンコーディング
  • 音声エンコーディング
  • 画像処理
  • ドキュメント処理
  • 人工知能
  • ファイルフィルタリングとセキュリティ
  • メディアカタログ化
  • ファイル圧縮
  • コード評価
  • ファイルエクスポート
  • Smart CDN
  • すべてのサービスを表示
  • 連携機能を見る
  • 実行可能なデモを試す (English)
  • Uppy
  • TransloaditKit
  • Android 用 SDK
  • Node.js 用 SDK
  • Next.js 用ビューアー
  • Python 用 SDK
  • Ruby 用 SDK
  • Go 用 SDK
  • Java 用 SDK
  • PHP 用 SDK
  • Zapier
  • MCP サーバー
  • Transloadit CLI
  • Terraform
  • 基本事項
  • ベストプラクティス
  • よくある質問
  • Robot
  • API
  • 形式
  • 初めてのアプリ開発
  • 会社概要
  • 比較
  • オープンソース
  • お客様の声
  • 採用情報 (English)
  • セキュリティ
  • 記事
  • 開発者ニュース (English)
  • 開発のヒント
  • プレス
  • 研究 (English)
  • 導入事例
  • ソリューション
  • ガイド (English)
  • 用語集
  • 法務 (English)
  • ツール
  • 世界中の数百万人に教育を届ける Coursera を支援
  • Transloadit サポート
  • オープンソースサポート
  • サービスレベル契約 (English)
  • エンジニアによるデモを予約 (English)
基本事項Robotよくある質問API形式ベストプラクティス
トピック
  • エンドポイント
  • レスポンスコード
  • 認証
  • ウェブフック
  • メタデータ
  • API のセキュリティ
  • レート制限
  • キュー
  • 再開可能なアップロード
認証
  • Bearer トークンを作成する
  • 新しい Auth Key を作成する
  • Auth Keys の一覧を取得する
  • Auth Key のスコープを取得する
  • Auth Key を編集する
  • Auth Key を削除する
  • Auth Key のシークレットを取得する
Assemblies
  • 新しい Assembly を作成する
  • Assembly Status を取得する
  • 指定された ID で Assembly を作成する
  • Assembly の変更をリアルタイムでストリーミングする
  • 実行中の Assembly をキャンセルする
  • Assembly を再実行する
  • Assemblies の一覧を取得する
  • Assembly Status レスポンス
  • Assembly の統計情報を取得する
ウェブフック
  • Assembly Notifications を取得する
  • Assembly Notification を再送する
請求
  • 対象月の請求書を取得する
キュー
  • 現在使用中の Priority Job Slots を取得する
  • Priority Job Slots の統計を取得する
再開可能なアップロード
  • tus の機能を確認する
  • tus アップロードを作成する
  • tus アップロードのオフセットを取得する
  • tus ファイルのバイト列をアップロードする
  • tus アップロードを終了する
  • tus アップロードをダウンロードする
Template 認証情報
  • 新しい Template 認証情報を作成する
  • Template 認証情報を取得する
  • Template 認証情報を編集する
  • Template 認証情報を削除する
  • Template 認証情報の一覧を取得する
  • Template 認証情報の種類を取得する
Templates
  • 新しい Template を作成する
  • Template を取得する
  • Template を編集する
  • Template を削除する
  • Templates の一覧を取得する
  • Cron Template の実行履歴を取得する alpha
デジタルアセット管理
  • DAM アセットを移動するか、名前を変更する alpha
  • DAM アセットを削除 alpha
  • DAM アセットを一括移動する alpha
  • DAM アセットを一括削除する alpha
  • ストレージ内のファイルまたはフォルダーを移動 alpha
  • ストレージ内のアセットを取得
  • ストレージ内のアセットを一覧表示

Template を編集する

ID または名前を指定して、既存の Template を更新します。

PUThttps://api2.transloadit.com/templates/{templateIdOrName}

TEMPLATE_ID_OR_NAME で指定される Template を更新します。省略されたトップレベルの設定は通常変更されないため、以下のリクエスト例では Instructions を変更せずに Template の名前を変更します。

template を指定すると、保存されている Instructions 全体が置き換えられます。個々の Steps をマージしたり、パッチを適用したりすることはありません。そのオブジェクトには、保持したいすべての Steps と Instructions を含めてください。

Cron スケジューリングは、アクセス制御されたプレビュー機能です。参加する各 Workspace で 1 つの Template を有効にでき、UTC の 1 日あたりに受け付けられるティックは最大 10,000 回です。cron_enabled を true に設定する前に、cron_region、6 フィールドの cron_schedule_with_seconds、cron_auth_key_id を指定してください。選択した Auth Key は、この Workspace に属し、Assembly の作成を許可している必要があります。また、有効なスケジュールを有効化または編集する場合、呼び出し元にも Assembly の作成権限が必要です。スケジューリングの無効化には Assembly の作成権限は必要ありません。スケジューリングが利用できなくなった場合、または Workspace がプレビューへのアクセス権を失った場合、通常の Template 編集によってスケジューリングは自動的に無効になりますが、リージョン、スケジュール、Auth Key ID、既存の実行は保持されます。Template を無効にするか、その Workspace、リージョン、またはスケジューラーを一時停止すると、以後のティックの受け付けが停止します。すでに永続的に受け付けられたティックは、その後も完了する可能性があります。

スケジュールは UTC で実行され、連続するすべてのティックの間隔を 10 秒以上に保つ必要があります。Instructions では自己完結した HTTP または S3 のインポートを使用する必要があり、:original または /upload/handle を通じてアップロードされたファイルに依存することはできません。スケジュール実行される Assemblies は、最大 1,000 個の入力ファイルをインポートし、max_number_of_files にそれより低い上限が記述されている場合は、その上限に従います。実行に関する変更は、次に到来するティックで有効になります。実行されなかったティックはスキップされます。cron_max_concurrent_runs のデフォルトは 1 です。スケジュールによる同時実行を許可するには、最大 10 まで増やしてください。保留中の開始と未解決の実行は、Template の編集や無効化と再有効化のサイクルをまたいで、この上限に算入されます。上限に達すると、ティックは結果と理由がともに overlap としてスキップされます。後で実行するためにキューに入れられることはありません。上限を引き下げても、既存の実行はキャンセルされません。手動の Assemblies はこの上限に算入されず、通常の Workspace の制限は引き続き適用されます。この設定は、インポートされたファイルの重複を排除しません。Assembly チェックポイントのない消費済みの開始は、設定可能なタイムアウトに達するまでスロットを保持します。このタイムアウトのデフォルトは 10 分です。その後、理由 start_checkpoint_missing で lost とマークされ、以後のティックを実行できるようになります。そのティックが再試行されることはありません。クラッシュしたスケジュール実行の Assembly は再試行されません。その実行は理由 crashed_not_retried で failed とマークされ、重複実行枠を直ちに解放します。Assembly はクラッシュ状態のままで、通常のエラー Notification を送信します。次のスケジュール実行は通常どおり進みます。中止または失敗した Assemblies は、それらの Jobs が終了するまで重複実行枠を保持します。最終チェックポイントが届かない場合は、Workspace の Assembly の最大存続時間にチェックポイントの猶予期間を加えた時間が経過すると期限切れになり、クラッシュとしてマークされ、中止または失敗した処理を再試行せずに重複実行枠を解放します。遅れて届いた Assembly チェックポイントは、保持されている結果を理由 start_checkpoint_late で修正します。lost になった実行は、スロットを恒久的に解放します。そのため、遅延した Assembly によって、デフォルトの 1 を含め、設定された上限を一時的に超える可能性があります。これは厳密な実行ミューテックスではありません。

リクエスト例

TEMPLATE_ID_OR_NAME を、パーセントエンコードせずにリソースの値に設定してください。

curl が利用でき、TRANSLOADIT_TOKEN に適切な Bearer トークン が設定されているサーバー側のシェルで、このリクエストを実行してください。トークンが必要な場合は、以下のセットアップを展開してください。

Bearer トークンが必要ですか?

curl と jq が利用できる信頼できるサーバー側のシェルで、TRANSLOADIT_KEY と TRANSLOADIT_SECRET に、それぞれ Auth Key と Auth Secret を設定してください。両方の認証情報と生成されたトークンは秘密にしてください。このセットアップをブラウザーのコードで実行しないでください。

まず、このエンドポイントで必要なスコープを持つトークンを作成します。Auth Key には、すでにそれらのスコープが付与されている必要があります。

if ! TOKEN_RESPONSE="$(curl --fail-with-body -sS \
  --request POST \
  --url 'https://api2.transloadit.com/token' \
  --user "${TRANSLOADIT_KEY:?Set TRANSLOADIT_KEY}:${TRANSLOADIT_SECRET:?Set TRANSLOADIT_SECRET}" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'aud=api2' \
  --data-urlencode 'scope=templates:write')"; then
  printf '%s\n' "$TOKEN_RESPONSE" >&2
  exit 1
fi
TRANSLOADIT_TOKEN="$(printf '%s' "$TOKEN_RESPONSE" |
  jq -er '.access_token | strings | select(length > 0)')" || exit 1

このシェルを開いたまま、以下のリクエストを実行してください。トークンが有効な間は、再利用してください。

curl --fail-with-body -sS --request PUT \
  --url "https://api2.transloadit.com/templates/${TEMPLATE_ID_OR_NAME:?Set TEMPLATE_ID_OR_NAME}" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --data-urlencode 'params={"name":"resized-images"}'

認証

このエンドポイントは、署名付きの params または Bearer トークンを受け付けます。設定手順については、認証を参照してください。

Auth Key または Bearer トークンに必要なスコープ: templates:write。

Signature 付きリクエストには、signature と、将来の時刻を示す params.auth.expires タイムスタンプの両方が必要です。Bearer トークンには、どちらも必要ありません。

パスパラメーター

  • templateIdOrName (パスセグメント)、必須。パターン: ^[a-z0-9-]+$, 最小長: 1

フォームフィールド

コンテンツタイプ: application/x-www-form-urlencoded

  • params (JSON 文字列)、必須。JSON エンコードされたオブジェクトで、サポートされるキーは以下のとおりです。

  • signature (文字列)。署名付きリクエストでは必須です。Bearer トークンを使用する場合は、このフィールドを省略してください。

params フィールド内でサポートされるキー

この一覧の認証フィールドは、署名付きリクエストに適用されます。Bearer トークンを使用する場合は、params.auth と、それとは別の signature フィールドを省略できます。以下の認証方式ごとのリクエストパラメーターを比較してください。

完全な JSON スキーマ

JSON を新しいタブで開く

params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

フィールド型と説明
params.assembly_status_expiry
"1day" | "30days" | "7days" | "90days" | "NoSave"

この Template から作成された Assemblies の Assembly Status を保持する期間を制御します。

params.auth

署名付きリクエストでは必須。Bearer トークンを使用する場合は任意

object

Template リクエスト用の Transloadit API キーと Signature Authentication のメタデータを含みます。

params.auth: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

params.auth.expires

必須

string

将来の日時を示す ISO 8601 形式の有効期限タイムスタンプ。リクエストが署名されている場合、または Signature Authentication が必要な場合は必須です。Bearer 認証を使用するリクエストでは省略できます。

params.auth.key

必須

string

リクエストの認証に使用する Transloadit API キー

params.cron_auth_key_id
string | null

この Workspace に属し、Assemblies の作成権限を持つ、アクティブで有効期限内の Auth Key の ID。Cron Template のプレビューを有効にする場合に必須です。このキーは署名を許可している必要があり、内部キーであってはなりません。

検証パターン(正規表現)^[a-f0-9]{32}$
params.cron_enabled
boolean

Cron Template のプレビューを有効または無効にします。有効化、または有効なスケジュールの編集には、呼び出し元に Assembly の作成権限が必要です。省略した場合、スケジューリングが引き続き利用可能であれば現在の設定が維持されますが、プレビューへのアクセスが取り消されている場合は、通常の編集によってスケジューリングが自動的に無効になります。利用条件を満たす各 Workspace では、Cron Template を 1 つ有効にできます。Instructions は自己完結している必要があり、:original や /upload/handle を使用せず、HTTP または S3 からのインポートを使用する必要があります。逃した実行タイミングはスキップされ、Template が同時実行数の上限に達している場合も、その実行タイミングはスキップされます。

params.cron_max_concurrent_runs
integer (最小値: 1, 最大値: 10)

この Template のスケジュール実行の最大同時実行数。作成時のデフォルトは 1 です。更新時に省略すると、保存済みの上限が維持されます。上限に達している場合、定期実行のトリガーはキューに入れられず、スキップされます。開始待ちの実行と未解決の実行は、完了するかチェックポイント喪失のタイムアウトに達するまでカウントされます。失われた実行のスロットは恒久的に解放されるため、遅延した Assembly によって一時的にこの上限を超えることがあります。インポートされたファイルの重複排除や、手動の Assemblies の制限は行いません。通常の Workspace の制限は引き続き適用されます。

params.cron_region
"ap-southeast-1" | "eu-west-1" | "us-east-1" | null

スケジュールされた Assemblies に使用するリージョン API。Cron Template のプレビューを有効にする場合に必須です。

params.cron_schedule_with_seconds
string | null (最小長: 1, 最大長: 255)

UTC で評価される、6 フィールドの数値形式の cron 式です。各フィールドは、秒、分、時、日、月、曜日を表します。ワイルドカード、カンマ区切りの値、範囲、ステップに対応しています。スケジュール上の実行タイミングは、10 秒以上離れている必要があります。cron による Template のスケジューリングは、アクセス制御されたプレビュー機能です。

params.name
string (最小長: 3, 最大長: 200)

この Template の名前。小文字のラテン文字、数字、またはハイフンを 3–200 文字使用してください。tmp およびサービスが予約している名前は使用できません。

検証パターン(正規表現)^(?:[a-su-z0-9-][a-z0-9-]{2,199}|t[a-ln-z0-9-][a-z0-9-]{1,198}|tm[a-oq-z0-9-][a-z0-9-]{0,197}|tmp[a-z0-9-]{1,197})$
params.nonce
string | integer

各 Signature を一意にし、Signature の意図しない再利用を防ぐために、署名付きリクエストのパラメーターに含める一意のランダムな値。

params.require_signature_auth
0 | 1

Auth Key を使用してこの Template から Assemblies を作成する際に、有効な Signature を必須にするには、1 を使用します。有効な Bearer トークンはこの Signature 要件をバイパスしますが、そのスコープとオーディエンスは引き続き適用されます。この設定は、Assembly Status 用、キャンセル用、またはアップロード用のケイパビリティ URL に認証を追加するものではありません。Signature Authentication を参照してください。

params.template
object | string

この Template に保存されている Assembly Instructions。構造化された JSON オブジェクトを優先して使用してください。互換性のため、JSON エンコードされた文字列も引き続き受け付けます。

次のいずれかのスキーマが適用される場合があります:

object
object

この Template に保存されている構造化された Assembly Instructions。

params.template: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

フィールド型と説明
params.template.allow_steps_override
boolean

保存済みの Template でこれを false に設定すると、実行時にその Steps を上書きできなくなります。その場合、template_id を指定して Template を使用するか、それを指定せずに steps を直接指定するかのいずれか一方のみが可能です。Assembly の作成時にのみ指定した値では、このポリシーは制御されません。

params.template.auth
object

Assembly 用のオプションの認証設定とアップロード制約。Bearer 認証を使用するリクエストの場合、または Template にアップロード制約のみが保存されている場合は、API キーを省略できます。

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

params.template.emit_execution_progress
boolean

リアルタイムの Assembly Execution Progress イベントを発行するには、true に設定します。URL 変換の Assemblies では、この設定は無視されます。

params.template.exiftool_stack
string

Template に保存された場合は無視されます。メタデータ抽出に使用する ExifTool スタックを選択するには、代わりに Assembly リクエストのトップレベルの params に exiftool_stack を設定してください。

params.template.ffmpeg_stack
string

Template に保存されている場合は無視されます。メタデータ抽出に使用する FFmpeg スタックを選択するには、代わりにトップレベルの Assembly リクエストパラメーターで ffmpeg_stack を設定してください。

params.template.fields
object

文字列をキーとする値のオブジェクト(名前 -> 値)で、追加のフォームフィールドと同様に Assembly Variables として使用できます。値には、JSON として文字列化できるものであれば何でも使用できます。

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

params.template.imagemagick_stack
string

Template に保存されている場合は無視されます。メタデータ抽出に使用する ImageMagick スタックを選択するには、代わりに Assembly リクエストのトップレベルの params で imagemagick_stack を設定してください。

params.template.mediainfo_stack
string

Template に保存された場合は無視されます。メタデータ抽出に使用する MediaInfo スタックを選択するには、代わりに Assembly リクエストのトップレベルパラメーターで mediainfo_stack を設定してください。

params.template.mplayer_stack
string

Template に保存された場合は無視されます。メタデータ抽出に MPlayer スタックを選択するには、代わりに Assembly リクエストのトップレベルの params で mplayer_stack を設定してください。

params.template.notification_payload
Array<"without_params" | "without_result_meta_data" | "without_results" | "without_upload_meta_data" | "without_uploads">

Assembly Notifications で送信されるペイロードのサイズを制御します。Notification の再送では、元の Assembly リクエストで指定されたフィルターが再利用されます。Template 内でのみ定義されたフィルターは、再送時には保持されません。空の配列(デフォルト)を指定すると、完全な Assembly Status が送信されます。トップレベルの未加工の Assembly Instructions フィールド params、template、merged_params を省略するには、"without_params" を追加してください。results 内の各ファイルから meta を省略するには、"without_result_meta_data" を追加してください。トップレベルの results オブジェクトを省略するには、"without_results" を追加してください。uploads 内の各ファイルから meta を省略するには、"without_upload_meta_data" を追加してください。トップレベルの uploads 配列を省略するには、"without_uploads" を追加してください。フィルタリングはシリアライズ前に適用されるため、これらのオプションを使用するとメモリ使用量が減り、大規模な Assemblies でのペイロードのサイズ超過や OOM による失敗を回避しやすくなります。

params.template.notify_url
null | string

Transloadit は、Assembly が完了したときにサーバーへピングバックを送信できます。ここで指定された URL に、application/x-www-form-urlencoded の POST リクエストの transloadit フィールドで、Assembly Status を JSON 文字列として送信します。ペイロードのサイズを減らすには、notification_payload を使用してください(例: without_uploads、without_results、without_params)。Notification の再送時には、元の Assembly リクエストで指定されたフィルターのみが再利用され、Template でのみ定義されたフィルターは再利用されません。

params.template.quiet
boolean

Assembly 作成時の初期レスポンスを最小限に抑えるには、これを true に設定してください。成功時のレスポンスには ok と assembly_id のみが含まれます。エラーレスポンスでは、error、http_code、message、reason、および assembly_id が、利用可能な場合に保持されます。これはレスポンスの最小化であり、アクセス制御ではありません。返された Assembly ID を持つ人は誰でも、追加の認証なしで、フィールドと結果を含む完全な Assembly Status を引き続き取得できます。Assembly IDs とステータス URL は、秘密のケイパビリティとして扱ってください。notify_url が設定されている場合は、完全な Assembly Status が引き続き notify_url に送信されます。

params.template.redirect_url
string

ブラウザーからのアップロードが完了した後のリダイレクト先 URL。既存のクエリパラメーターとフラグメントを保持したまま、Assembly ID とステータス URL がクエリパラメーターとして追加されます。

params.template.response_headers
object

Assembly が出力する CORS レスポンスヘッダーです。以下に示す CORS ヘッダーを response_headers.cors 内、またはトップレベルに設定します。例: response_headers: { "cors": { "Access-Control-Allow-Origin": "https://example.com", "Access-Control-Allow-Methods": "GET, POST, OPTIONS" } }。ヘッダー名は大文字と小文字を区別しません。それ以外のヘッダー名と無効なヘッダー値は無視されます。コンテンツ、フレーミング、Cookie、リダイレクトは引き続き API によって制御されます。

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

params.template.steps
参照先のスキーマ

Assembly Instructions を含みます。

スキーマに関する追加の詳細は、完全な JSON Schema で確認できます。

params.template.template_id
string

Template 内に保存されている場合は無視されます。Templates は別の Template から Instructions を継承しません。Steps をこの Template に直接記述し、トップレベルの Assembly リクエストパラメーターの template_id を使用して、この Template を選択してください。

params.template.usage_tags
string

Assembly に記録された使用状況タグ。

string
string

クライアントとの互換性のために保持されている、JSON エンコードされた Assembly Instructions。

検証パターン(正規表現)^[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]*\{(?:[^\x00]|\x00)*\}[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]*$
params.transcoding_result_expiry
"1day" | "NoSave"

この Template から作成される Assemblies のトランスコード結果を保持する期間を制御します。

認証方式別のリクエストパラメーター

署名付き params

Auth Key を params.auth.key として含めてください。リクエストに署名する場合は、将来の時刻を示す params.auth.expires タイムスタンプを含め、Signature を別の signature フィールドで送信してください。以下のフィールド定義では、params 内のパスを使用しています。

完全な JSON スキーマ

JSON を新しいタブで開く

params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

上記のフィールド定義を使用します: params.assembly_status_expiry, params.auth, params.cron_auth_key_id, params.cron_enabled, params.cron_max_concurrent_runs, params.cron_region, params.cron_schedule_with_seconds, params.name, params.nonce, params.require_signature_auth, params.template, params.transcoding_result_expiry

Bearer トークンを使用する場合

Bearer トークンを Authorization ヘッダーで送信してください。params.auth と、それとは別の signature フィールドは省略できます。他の必須パラメーターの要件は引き続き適用されます。以下のフィールド定義では、params 内のパスを使用します。

完全な JSON スキーマ

JSON を新しいタブで開く

params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

上記のフィールド定義を使用します: params.assembly_status_expiry, params.cron_auth_key_id, params.cron_enabled, params.cron_max_concurrent_runs, params.cron_region, params.cron_schedule_with_seconds, params.name, params.nonce, params.require_signature_auth, params.template, params.transcoding_result_expiry

フィールド型と説明
params.auth
object

Template リクエスト用の Transloadit API キーと Signature Authentication のメタデータを含みます。

params.auth: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。

params.auth.expires
string

将来の日時を示す ISO 8601 形式の有効期限タイムスタンプ。リクエストが署名されている場合、または Signature Authentication が必要な場合は必須です。Bearer 認証を使用するリクエストでは省略できます。

params.auth.key
string

リクエストの認証に使用する Transloadit API キー

レスポンス

レスポンスボディの例を以下に示します:

{
  "assembly_status_expiry": null,
  "content": {
    "steps": {
      "resize": {
        "robot": "/image/resize",
        "use": ":original",
        "width": 320
      }
    }
  },
  "id": "8fc3b9166c784afd824acf24269ebd11",
  "message": "Your Template was successfully updated.",
  "name": "resized-images",
  "ok": "TEMPLATE_UPDATED",
  "require_signature_auth": 0,
  "transcoding_result_expiry": null
}

2xx 成功

JSON レスポンスの本文。 application/json text/plain; charset=utf-8

レスポンスボディのスキーマ
完全な JSON スキーマ

JSON を新しいタブで開く

レスポンスには、このオブジェクトについて記載されているフィールドのみが含まれます。

フィールド型と説明
assembly_status_expiry

必須

null | string
content

必須

object | Array<任意の値> | string | number | boolean | null

次のいずれかのスキーマが適用される場合があります:

object
object
追加プロパティのスキーマ
任意の値
Array<任意の値>
Array<任意の値>
配列要素のスキーマ
任意の値
string
number
boolean
null
cron_auth_key_id
string | null
検証パターン(正規表現)^[a-f0-9]{32}$
cron_enabled
boolean
cron_max_concurrent_runs
integer (最小値: 1, 最大値: 10)
cron_region
"ap-southeast-1" | "eu-west-1" | "us-east-1" | null
cron_schedule_with_seconds
string | null (最小長: 1, 最大長: 255)
id

必須

string

次のいずれかのスキーマが適用される場合があります:

バリアント 1: string (最大長: 32)
string
検証パターン(正規表現)^[\x00-\x7F]*$
バリアント 2: string (最大長: 32)
string
検証パターン(正規表現)^builtin\/[a-z0-9-]+(?:@[0-9a-z.-]+)?$
message

必須

string (最小長: 1)
name

必須

string (最小長: 1, 最大長: 255)
ok

必須

string (常に: "TEMPLATE_UPDATED")
require_signature_auth

必須

0 | 1
transcoding_result_expiry

必須

null | string

エラーレスポンス

JSON レスポンスの本文。 application/json text/plain; charset=utf-8

レスポンスボディのスキーマ
完全な JSON スキーマ

JSON を新しいタブで開く

次のプロパティのうち、少なくとも 1 つが必須です: error, message, reason

レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
assembly_id
string
error
string (最小長: 1)
http_code
number | string
  • number
  • string
    検証パターン(正規表現)^[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]*[+-]?0*(?:0(?:[^0-9]|$)|(?:[1-9][0-9]{0,307}|1(?:(?:[0-6][0-9]{7}|7[0-8][0-9]{6}|79[0-6][0-9]{5}|797[0-5][0-9]{4}|7976[0-8][0-9]{3}|79769[0-2][0-9]{2}|7976930[0-9]{1}|7976931[0-2])[0-9]{300}|79769313(?:(?:[0-3][0-9]{7}|4[0-7][0-9]{6}|48[0-5][0-9]{5}|486[0-1][0-9]{4}|4862[0-2][0-9]{3}|486230[0-9]{2}|486231[0-4][0-9]{1}|4862315[0-7])[0-9]{292}|48623158(?:(?:0[0-6][0-9]{6}|07[0-8][0-9]{5}|079[0-2][0-9]{4}|0793[0-6][0-9]{3}|07937[0-1][0-9]{2}|079372[0-7][0-9]{1}|0793728[0-8])[0-9]{284}|07937289(?:(?:[0-6][0-9]{7}|70[0-9]{6}|71[0-3][0-9]{5}|7140[0-4][0-9]{3}|71405[0-2][0-9]{2}|7140530[0-2])[0-9]{276}|71405303(?:(?:[0-3][0-9]{7}|40[0-9]{6}|41[0-4][0-9]{5}|4150[0-6][0-9]{3}|41507[0-8][0-9]{2}|415079[0-8][0-9]{1}|4150799[0-2])[0-9]{268}|41507993(?:(?:[0-3][0-9]{7}|40[0-9]{6}|41[0-2][0-9]{5}|413[0-1][0-9]{4}|4132[0-6][0-9]{3}|413270[0-9]{2})[0-9]{260}|41327100(?:(?:[0-2][0-9]{7}|3[0-6][0-9]{6}|37[0-7][0-9]{5}|378[0-1][0-9]{4}|3782[0-5][0-9]{3}|37826[0-8][0-9]{2}|378269[0-2][0-9]{1}|3782693[0-5])[0-9]{252}|37826936(?:(?:0[0-9]{7}|1[0-6][0-9]{6}|17[0-2][0-9]{5}|173[0-6][0-9]{4}|1737[0-6][0-9]{3}|17377[0-7][0-9]{2}|173778[0-8][0-9]{1}|1737789[0-7])[0-9]{244}|17377898(?:(?:0[0-3][0-9]{6}|04[0-3][0-9]{5}|044[0-3][0-9]{4}|0444[0-8][0-9]{3}|04449[0-5][0-9]{2}|044496[0-7][0-9]{1}|0444968[0-1])[0-9]{236}|04449682(?:(?:[0-8][0-9]{7}|9[0-1][0-9]{6}|92[0-6][0-9]{5}|927[0-5][0-9]{4}|9276[0-3][0-9]{3}|92764[0-6][0-9]{2}|927647[0-4][0-9]{1})[0-9]{228}|92764750(?:(?:[0-8][0-9]{7}|9[0-3][0-9]{6}|94[0-5][0-9]{5}|946[0-5][0-9]{4}|9466[0-3][0-9]{3}|94664[0-8][0-9]{2}|94664900)[0-9]{220}|94664901(?:(?:[0-6][0-9]{7}|7[0-8][0-9]{6}|79[0-6][0-9]{5}|797[0-6][0-9]{4}|7977[0-4][0-9]{3}|79775[0-7][0-9]{2}|797758[0-6][0-9]{1}|7977587[0-1])[0-9]{212}|79775872(?:(?:0[0-6][0-9]{6}|070[0-8][0-9]{4}|0709[0-5][0-9]{3}|07096[0-2][0-9]{2}|070963[0-2][0-9]{1})[0-9]{204}|07096330(?:(?:[0-1][0-9]{7}|2[0-7][0-9]{6}|28[0-5][0-9]{5}|286[0-3][0-9]{4}|28640[0-9]{3}|28641[0-5][0-9]{2}|286416[0-5][0-9]{1}|2864166[0-8])[0-9]{196}|28641669(?:(?:[0-1][0-9]{7}|2[0-7][0-9]{6}|28[0-7][0-9]{5}|288[0-6][0-9]{4}|2887[0-8][0-9]{3}|288790[0-9]{2}|2887910[0-8])[0-9]{188}|28879109(?:(?:[0-3][0-9]{7}|4[0-5][0-9]{6}|46[0-4][0-9]{5}|465[0-4][0-9]{4}|4655[0-4][0-9]{3}|46555[0-4][0-9]{2}|465555[0-3][0-9]{1}|4655554[0-6])[0-9]{180}|46555547(?:(?:[0-7][0-9]{7}|8[0-4][0-9]{6}|850[0-9]{5}|851[0-8][0-9]{4}|8519[0-3][0-9]{3}|851940[0-3][0-9]{1})[0-9]{172}|85194040(?:(?:[0-1][0-9]{7}|2[0-5][0-9]{6}|26[0-2][0-9]{5}|2630[0-5][0-9]{3}|26306[0-4][0-9]{2}|263065[0-6][0-9]{1}|2630657[0-3])[0-9]{164}|26306574(?:(?:[0-7][0-9]{7}|8[0-7][0-9]{6}|88[0-5][0-9]{5}|886[0-6][0-9]{4}|88670[0-9]{3}|88671[0-4][0-9]{2}|8867150[0-4])[0-9]{156}|88671505(?:(?:[0-7][0-9]{7}|8[0-1][0-9]{6}|820[0-5][0-9]{4}|8206[0-7][0-9]{3}|820680[0-9]{2}|820681[0-8][0-9]{1})[0-9]{148}|82068190(?:(?:[0-7][0-9]{7}|8[0-8][0-9]{6}|890[0-1][0-9]{4}|8902000[0-6])[0-9]{140}|89020007(?:(?:0[0-7][0-9]{6}|08[0-2][0-9]{5}|083[0-7][0-9]{4}|0838[0-2][0-9]{3}|08383[0-5][0-9]{2}|083836[0-6][0-9]{1}|0838367[0-5])[0-9]{132}|08383676(?:(?:[0-1][0-9]{7}|2[0-6][0-9]{6}|27[0-2][0-9]{5}|273[0-7][0-9]{4}|2738[0-4][0-9]{3}|27385[0-3][0-9]{2}|273854[0-7][0-9]{1}|2738548[0-3])[0-9]{124}|27385484(?:(?:[0-4][0-9]{7}|5[0-7][0-9]{6}|580[0-9]{5}|581[0-6][0-9]{4}|5817[0-6][0-9]{3}|581770[0-9]{2}|5817710[0-9]{1}|5817711[0-4])[0-9]{116}|58177115(?:(?:[0-2][0-9]{7}|30[0-9]{6}|31[0-6][0-9]{5}|317[0-5][0-9]{4}|3176[0-3][0-9]{3}|31764[0-3][0-9]{2}|317644[0-6][0-9]{1}|3176447[0-4])[0-9]{108}|31764475(?:(?:[0-6][0-9]{7}|7[0-2][0-9]{6}|730[0-1][0-9]{4}|7302[0-6][0-9]{3}|7302700[0-5])[0-9]{100}|73027006(?:(?:[0-8][0-9]{7}|9[0-7][0-9]{6}|98[0-4][0-9]{5}|985[0-4][0-9]{4}|9855[0-4][0-9]{3}|98555[0-6][0-9]{2}|9855570[0-9]{1}|9855571[0-2])[0-9]{92}|98555713(?:(?:[0-5][0-9]{7}|6[0-5][0-9]{6}|66[0-8][0-9]{5}|669[0-4][0-9]{4}|6695[0-8][0-9]{3}|66959[0-5][0-9]{2}|669596[0-1][0-9]{1}|6695962[0-1])[0-9]{84}|66959622(?:(?:[0-7][0-9]{7}|8[0-3][0-9]{6}|84[0-1][0-9]{5}|842[0-8][0-9]{4}|84290[0-9]{3}|84291[0-3][0-9]{2}|842914[0-7][0-9]{1}|84291480)[0-9]{76}|84291481(?:(?:[0-8][0-9]{7}|9[0-7][0-9]{6}|98[0-5][0-9]{5}|9860[0-7][0-9]{3}|98608[0-2][0-9]{2}|986083[0-3][0-9]{1}|9860834[0-8])[0-9]{68}|98608349(?:(?:[0-2][0-9]{7}|3[0-5][0-9]{6}|36[0-3][0-9]{5}|364[0-6][0-9]{4}|3647[0-4][0-9]{3}|36475[0-1][0-9]{2}|364752[0-8][0-9]{1}|3647529[0-1])[0-9]{60}|36475292(?:(?:[0-6][0-9]{7}|70[0-9]{6}|71[0-8][0-9]{5}|7190[0-6][0-9]{3}|71907[0-3][0-9]{2}|7190740[0-9]{1}|7190741[0-5])[0-9]{52}|71907416(?:(?:[0-7][0-9]{7}|8[0-3][0-9]{6}|84[0-3][0-9]{5}|844[0-3][0-9]{4}|8444[0-2][0-9]{3}|84443[0-5][0-9]{2}|844436[0-4][0-9]{1}|8444365[0-4])[0-9]{44}|84443655(?:(?:0[0-9]{7}|10[0-6][0-9]{5}|1070[0-3][0-9]{3}|10704[0-2][0-9]{2}|107043[0-3][0-9]{1}|1070434[0-1])[0-9]{36}|10704342(?:(?:[0-6][0-9]{7}|70[0-9]{6}|710[0-9]{5}|711[0-4][0-9]{4}|7115[0-4][0-9]{3}|71155[0-8][0-9]{2}|711559[0-5][0-9]{1}|7115596[0-8])[0-9]{28}|71155969(?:(?:[0-8][0-9]{7}|9[0-4][0-9]{6}|950[0-7][0-9]{4}|95080[0-8][0-9]{2}|950809[0-2][0-9]{1})[0-9]{20}|95080930(?:(?:[0-3][0-9]{7}|4[0-1][0-9]{6}|42[0-7][0-9]{5}|428[0-7][0-9]{4}|428800[0-9]{2}|428801[0-6][0-9]{1}|4288017[0-6])[0-9]{12}|42880177(?:(?:[0-8][0-9]{7}|90[0-3][0-9]{5}|9040[0-9]{4}|9041[0-6][0-9]{3}|90417[0-3][0-9]{2}|904174[0-3][0-9]{1}|9041744[0-8])[0-9]{4}|90417449(?:(?:[0-6][0-9]{3}|7[0-6][0-9]{2}|77[0-8][0-9]{1}|7790)|7791))))))))))))))))))))))))))))))))))))))))(?:[^0-9]|$))
message
string

人が読んで理解できる形式のエラー説明です。文言は変わる場合があるため、特定の失敗を処理する際は error コードを使用してください。

reason
null | string | number | boolean | Array<任意の値> | object

次のいずれかのスキーマが適用される場合があります:

null
string
number
boolean
Array<任意の値>
Array<任意の値>
配列要素のスキーマ
任意の値
object
object
追加プロパティのスキーマ
任意の値

HTTP 400

JSON レスポンスの本文。 application/json text/plain; charset=utf-8

レスポンスボディのスキーマ
完全な JSON スキーマ

JSON を新しいタブで開く

名前付きエラーと一般的なエラー形式

error: "TEMPLATE_VALIDATION_ERROR"

Template が検証に合格しませんでした。

レスポンスには追加のフィールドが含まれる場合があります。

フィールド型と説明
error

必須

string (常に: "TEMPLATE_VALIDATION_ERROR")
http_code
number (常に: 400)
message
string

人が読んで理解できる形式のエラー説明です。文言は変わる場合があるため、特定の失敗を処理する際は error コードを使用してください。

一般的なエラー形式

一般的なエラーレスポンスのフィールドを参照してください。

前のページ ← Template を取得する次のページ Template を削除する →
サポートに問い合わせる
Transloadit稼働状況を確認中…

製品

  • サービス
  • 料金
  • デモ EN (English)
  • ツール
  • セキュリティ
  • サポート

会社

  • 会社概要/プレス
  • ブログ/採用情報 EN (English)
  • 比較/コンプライアンス対応表
  • 研究 EN (English)
  • オープンソース
  • ソリューション
  • ウェブの先駆者たち

ドキュメント

  • はじめに
  • トランスコーディング
  • よくある質問
  • API
  • ガイド EN (English)/開発のヒント
  • 対応フォーマット

その他

  • プラットフォームの稼働状況⁠
  • コミュニティフォーラム⁠
  • Uppy
  • tus⁠

© 2009–2026 Transloadit-II GmbH

Transloadit®、tus®、Uppy® は、米国における Transloadit-II GmbH の登録商標です。

プライバシー EN (English)利用規約 EN (English)運営者情報 EN (English)商標 EN (English)DMCA ポリシー EN (English)
EnglishDeutschEspañolFrançaisPortuguês (Brasil)日本語