Cron Template の実行履歴を取得する
Cron Template の保持されているティックを返します。
https://api2.transloadit.com/ templates/ {templateIdOrName}/ cron-runsこのエンドポイントはアルファ版です。URL、パラメーター、レスポンス、動作が大幅に変更され、既存の連携が動作しなくなる可能性があります。
TEMPLATE_ID_OR_NAME に、認証済みの Workspace が所有する Cron Template を指定してください。このアクセス制御されたプレビューは、過去 30 日間のティックを最大 100 件、新しい順に返します。より古いティックを取得するには、レスポンスの next_before の値を before として使用してください。値が null の場合は、それより古い、保持されているティックがないことを意味します。各エントリには、予定時刻、受け入れ時刻、完了時刻、結果、およびサニタイズされた理由コードが含まれます。スキップされた実行、重複した実行、一時停止された実行、曖昧な状態の実行も、完了した
Assemblies とともに保持されます。Assembly のチェックポイントが欠落している場合、設定されたタイムアウトが経過すると lost になります。このタイムアウトのデフォルトは 10 分です。初回の Assembly チェックポイントが遅れて届くことで、この lost という結果が修正される場合があります。スケジュールされた Assembly がクラッシュすると、ただちに理由 crashed_not_retried で failed とマークされます。再試行は行われず、次にスケジュールされた実行は通常どおり進みます。トップレベルの cron_disabled_reason は、現在のスケジュールが自動停止した理由を示します。consecutive_failures は、実行が 3 回連続で失敗したことを意味します。auth_key_unavailable、instructions_invalid、schedule_invalid、または dispatch_rejected は、恒久的な検証エラーまたはディスパッチの失敗を意味します。再開するには、問題を修正し、スケジュールを再度有効にしてください。この説明は、30 日間の履歴の保持期間を超えて残ります。再度有効にするか、スケジュール設定を変更すると、新しいスケジュールリビジョンが開始され、この説明がクリアされます。値が null または存在しない場合は、利用できる説明がないことを意味します。スケジュールが有効か一時停止中かを示すものではありません。認証情報と保存された Instructions がこのレスポンスに含まれることはありません。
リクエスト例
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:read')"; 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 GET --get \
--url "https://api2.transloadit.com/templates/${TEMPLATE_ID_OR_NAME:?Set TEMPLATE_ID_OR_NAME}/cron-runs" \
--header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
--data-urlencode 'params={}'
認証
このエンドポイントは、署名付きの params または Bearer トークンを受け付けます。設定手順については、認証を参照してください。
Auth Key または Bearer トークンに必要なスコープ: templates:read。
Signature 付きリクエストには、signature と、将来の時刻を示す params.auth.expires タイムスタンプの両方が必要です。Bearer トークンには、どちらも必要ありません。
パスパラメーター
templateIdOrName(パスセグメント)、必須。パターン:^[a-z0-9-]+$, 最小長: 1
クエリパラメーター
params(JSON 文字列)。JSON エンコードされたオブジェクトで、サポートされるキーは以下のとおりです。signature(文字列)。署名付きリクエストでは必須です。Bearer トークンを使用する場合は、このフィールドを省略してください。
署名対象の params フィールド内でサポートされるキー
この一覧の認証フィールドは、署名付きリクエストに適用されます。Bearer トークンを使用する場合は、params.auth と、それとは別の signature フィールドを省略できます。以下の認証方式ごとのリクエストパラメーターを比較してください。
完全な JSON スキーマ
params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。
| フィールド | 型と説明 |
|---|---|
params.署名付きリクエストでは必須。Bearer トークンを使用する場合は任意 | Template リクエスト用の Transloadit API キーと Signature Authentication のメタデータを含みます。
|
params.必須 | string将来の日時を示す ISO 8601 形式の有効期限タイムスタンプ。リクエストが署名されている場合、または Signature Authentication が必要な場合は必須です。Bearer 認証を使用するリクエストでは省略できます。 |
params.必須 | stringリクエストの認証に使用する Transloadit API キー |
params. | stringこの UTC ISO タイムスタンプより前にスケジュールされたティックを返します。最新のページを取得する場合は省略してください。30 日間の履歴期間内で次のページを取得するには、レスポンスの 検証パターン(正規表現)^(([0-9][0-9][2468][048]|[0-9][0-9][13579][26]|[0-9][0-9]0[48]|[02468][048]00|[13579][26]00)-02-29|[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|1[0-9]|2[0-8])))T([01][0-9]|2[0-3]):[0-5][0-9](:[0-5][0-9](\.[0-9]+)?)?(Z)$ |
params. | string | integer各 Signature を一意にし、Signature の意図しない再利用を防ぐために、署名付きリクエストのパラメーターに含める一意のランダムな値。 |
認証方式別のリクエストパラメーター
署名付き params
Auth Key を params.auth.key として含めてください。リクエストに署名する場合は、将来の時刻を示す params.auth.expires タイムスタンプを含め、Signature を別の signature フィールドで送信してください。以下のフィールド定義では、params 内のパスを使用しています。
完全な JSON スキーマ
params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。
上記のフィールド定義を使用します: params.auth, params.before, params.nonce
Bearer トークンを使用する場合
Bearer トークンを Authorization ヘッダーで送信してください。params.auth と、それとは別の signature フィールドは省略できます。他の必須パラメーターの要件は引き続き適用されます。以下のフィールド定義では、params 内のパスを使用します。
完全な JSON スキーマ
params: このオブジェクトでは、一覧に記載されているフィールドのみが受け付けられます。
上記のフィールド定義を使用します: params.before, params.nonce
| フィールド | 型と説明 |
|---|---|
params. | Template リクエスト用の Transloadit API キーと Signature Authentication のメタデータを含みます。
|
params. | string将来の日時を示す ISO 8601 形式の有効期限タイムスタンプ。リクエストが署名されている場合、または Signature Authentication が必要な場合は必須です。Bearer 認証を使用するリクエストでは省略できます。 |
params. | stringリクエストの認証に使用する Transloadit API キー |
レスポンス
レスポンスボディの例を以下に示します:
{
"message": "Your Template was successfully found.",
"next_before": null,
"ok": "TEMPLATE_FOUND",
"runs": [
{
"admitted_at": "2026-09-12T10:00:00.100Z",
"assembly_id": "31f8e3baa9ef4fb1bfc76e8267746c4c",
"attempts": 1,
"completed_at": "2026-09-12T10:00:02.000Z",
"generation": "1",
"id": "66530f0d34f041e98b3050b467e280f9",
"instructions_hash": "5a69d6a0b248c5f042aa76ba4c34e52ab81fcda8d486e068ef9e33f8bdc00f8d",
"missed_count": "0",
"missed_from": null,
"missed_through": null,
"outcome": "succeeded",
"reason": null,
"recovery_assembly_id": null,
"region": "us-east-1",
"scheduled_at": "2026-09-12T10:00:00.000Z"
}
],
"template_id": "8fc3b9166c784afd824acf24269ebd11"
}2xx 成功
JSON レスポンスの本文。 application/json text/plain; charset=utf-8
レスポンスボディのスキーマ
完全な JSON スキーマ
レスポンスには、このオブジェクトについて記載されているフィールドのみが含まれます。
| フィールド | 型と説明 | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
cron_disabled_reason | "auth_key_unavailable" | "consecutive_failures" | "dispatch_rejected" | "instructions_invalid" | "schedule_invalid" | null | ||||||||||||||||||||||||||||||||
message必須 | string (最小長: 1) | ||||||||||||||||||||||||||||||||
next_before必須 | string | null検証パターン(正規表現)^(([0-9][0-9][2468][048]|[0-9][0-9][13579][26]|[0-9][0-9]0[48]|[02468][048]00|[13579][26]00)-02-29|[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|1[0-9]|2[0-8])))T([01][0-9]|2[0-3]):[0-5][0-9](:[0-5][0-9](\.[0-9]+)?)?(Z)$ | ||||||||||||||||||||||||||||||||
ok必須 | string (常に: "TEMPLATE_FOUND") | ||||||||||||||||||||||||||||||||
runs必須 | Array<object> (最大項目数: 100)配列要素のスキーマ
| ||||||||||||||||||||||||||||||||
template_id必須 | string |
エラーレスポンス
JSON レスポンスの本文。 application/json text/plain; charset=utf-8
レスポンスボディのスキーマ
完全な JSON スキーマ
レスポンスには追加のフィールドが含まれる場合があります。
| フィールド | 型と説明 |
|---|---|
assembly_id | string |
error | string (最小長: 1) |
http_code | number | string
|
message | string人が読んで理解できる形式のエラー説明です。文言は変わる場合があるため、特定の失敗を処理する際は |
reason | null | string | number | boolean | Array<任意の値> | object次のいずれかのスキーマが適用される場合があります: nullstringnumberbooleanArray<任意の値>Array<任意の値>配列要素のスキーマ任意の値objectobject追加プロパティのスキーマ任意の値 |
HTTP 400
JSON レスポンスの本文。 application/json text/plain; charset=utf-8
レスポンスボディのスキーマ
完全な JSON スキーマ
名前付きエラーと一般的なエラー形式
error: "SIGNATURE_REUSE_DETECTED"
セキュリティ上の理由により、リクエストが拒否されました。これが誤りだと思われる場合は、サポートにお問い合わせください。
レスポンスには追加のフィールドが含まれる場合があります。