Assembly Notifications を取得する
元の Assembly Notification と、保存済みの手動リプレイ記録を一覧表示します。
https://api2.transloadit.com/ assembly_notifications/ {assemblyId}追加の認証なしで、Webhook の配信詳細を返します。
一覧には、元の Notification レコード(存在する場合)と、保存された手動リプレイのレコードが、開始時刻順に含まれます。自動再試行では同じレコードが更新されます。個別のエントリや、すべての配信試行の履歴は生成されません。
記録された status と response_code を確認して、配信結果を判断してください。2xx の response_code は配信の受領を示します。リプレイ API の成功だけでは、配信を確認できません。
Notification 一覧のエントリには、リプレイレスポンスの notification_id は公開されません。また、同時実行されるリプレイが同じ start タイムスタンプを共有することがあります。過去の成功レコードは、直前にリクエストしたリプレイの配信を確認するものではありません。特定のリプレイを識別するには、明示的に指定する notify_url のクエリ文字列に、アプリケーションで定義した一意のマーカーを含め、記録された url を受信側の配信ログと照合してください。機密情報ではないマーカーを使用してください。URL フラグメントは受信側に送信されません。
assembly_id を知っている人は誰でも、このリクエストを実行できます。Assembly IDs と
assembly_ssl_url の値は機密情報として扱い、公開したり、信頼できない相手と共有したりしないでください。Assembly IDs は安全ですか?を参照してください。
リクエスト例
リソースの値をパーセントエンコードせずに ASSEMBLY_ID に設定してください。
curl --fail-with-body -sS --request GET \
--url "https://api2.transloadit.com/assembly_notifications/${ASSEMBLY_ID:?Set ASSEMBLY_ID}"
パスパラメーター
assemblyId(パスセグメント)、必須。パターン:^[a-z0-9]{32}$
任意のレスポンスクエリパラメーター
callback(JavaScript コールバック名)。JSON レスポンスを JSONP コールバックでラップします。コールバック名は^(?:_jqjsp[0-9]*|jQuery[0-9]+_[0-9]+)$に一致する必要があります。最後に指定されたものだけが使用され、空の値は無視されます。コールバック名が無効な場合は HTTP 403 が返されます。変換後のレスポンスは HTTP 200 を使用します。コールバックはレスポンスのシリアライズ後に適用されます。
リクエスト
追加のリクエストボディやフィールドは必要ありません。
レスポンス
レスポンスボディの例を以下に示します:
{
"notifications": [
{
"assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
"error": null,
"response_code": 204,
"response_data": "",
"start": "2026-09-12T10:00:00.000Z",
"status": "successful",
"url": "https://example.com/webhooks/transloadit"
}
],
"ok": "ASSEMBLY_NOTIFICATIONS_LISTED"
}2xx 成功
JSON レスポンスの本文。 application/json text/plain; charset=utf-8
レスポンスボディのスキーマ
完全な JSON スキーマ
レスポンスには、このオブジェクトについて記載されているフィールドのみが含まれます。
| フィールド | 型と説明 | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
notifications必須 | Array<object>配列要素のスキーマ
| ||||||||||||||||||||
ok必須 | string (常に: "ASSEMBLY_NOTIFICATIONS_LISTED") |
エラーレスポンス
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追加プロパティのスキーマ任意の値 |