ウェブフック
ウェブフックを設定する
Assembly Instructions の中で、steps と同じ階層に notify_url を設定してください。Assembly が終端状態に達すると、Transloadit はその URL に HTTP POST を送信します。
200 以上 300 未満のステータスはいずれも配信の受領確認となります。リダイレクト、およびクライアントエラーやサーバーエラーは失敗として扱われます。デフォルトでは、Transloadit は失敗した配信を指数係数 1.97 で 5 回再試行します。
受領確認は受信を確認するものであり、処理の成功を確認するものではありません。検証済みペイロードの
ok の状態または error コードを調べて、Assemblies の完了、キャンセル、失敗を区別してください。Notification の再送では、終端状態ではない Assembly Status が配信されることもあります。すべての配信が完了を意味すると想定しないでください。
Notification のペイロードを制限する
デフォルトでは、ウェブフックには完全な Assembly Status が含まれます。notification_payload を、次のサポートされているフィルターを任意に組み合わせた配列に設定してください。
without_params: トップレベルの未加工の Assembly Instructions フィールドであるparams、template、merged_paramsが省略されます。without_result_meta_data:results内の各ファイルからmetaが省略されます。without_results: トップレベルのresultsオブジェクトが省略されます。without_upload_meta_data:uploads内の各ファイルからmetaが省略されます。without_uploads: トップレベルのuploads配列が省略されます。
Notification の再送では、元の Assembly リクエストで指定されたフィルターが再利用されます。Template 内でのみ定義されたフィルターは再送時に維持されないため、再送には初回の Notification で省略されたデータが含まれる場合があります。再送でも同じフィルターを使用する必要がある場合は、元の Assembly リクエストで
notification_payload を指定してください。
以下のペイロードスキーマでは、これらの省略が許可されています。アップロードが uploads に残っていても、そのアップロードの meta が存在しない場合があります。その他のフィールドは、Assembly Status における意味を維持します。互換性のため、追加されるフィールドを受け入れてください。ただし、文書化されていない診断用フィールドには依存しないでください。
Signature を検証する
Assembly のウェブフックは、application/x-www-form-urlencoded メディアタイプを使用します。transloadit フィールドにはシリアライズされたそのままの Assembly Status JSON が含まれ、signature フィールドには、その小文字の 16 進数表記の HMAC が含まれます。
ウェブフックを検証するには、次の手順に従ってください。
- ペイロード文字列を変更せずに、
transloaditとsignatureのフォームフィールドを読み取ります。 - 以下の説明に従って選択した信頼できる Auth Secret を使用し、正確な
transloadit文字列のバイト列に対してHMAC-SHA1の 16 進数ダイジェストを計算します。 - タイミング攻撃に対して安全な比較を使用して、計算したダイジェストを
signatureと比較します。 - Signatures が一致した後にのみ、
transloaditを JSON として解析します。
Assembly の初回の Notification は、その作成を認証した Auth Key の Auth Secret を使用します。これは、Assembly Replayによって作成された場合も同様です。Notification の再送では、最初に
Assembly Status に api_auth_key_id として記録されている Auth Key を検索します。そのキーが記録されていない、解決できない、削除されている、または検索に失敗した場合、Notification の再送では代わりに、認証済みの再送呼び出し元の Auth Secret を使用します。
Assembly Replays は、親の過去の api_auth_key_id を保持します。たとえば、キー A が
Assembly を作成し、キー B がそれを再実行した場合、新しい Assembly の初回の Notification は B のシークレットで署名されます。その Notification を再送する際には、B が両方の再実行・再送エンドポイントを呼び出し、両方のキーが引き続き有効であっても、A のシークレットが使用される場合があります。適用される親のシークレットと再実行による作成時のシークレットを、検証処理で使用できるようにしておいてください。1 つの Assembly のすべての配信で同じシークレットが使用されるとは想定しないでください。
検証用のシークレットは、未検証のペイロード内のフィールドからではなく、想定している Workspace と Assembly 用の信頼できるサーバー側設定から選択してください。設定済みのシークレットが複数適用される場合は、リクエストの Signature がそれらの信頼できるシークレットのいずれかと一致する場合にのみ、リクエストを受け入れてください。どれとも一致しない場合は、リクエストを拒否してください。再送を受け入れるために検証を省略しないでください。
現在の API リクエスト用の Signatures とは異なり、ウェブフックの signature は、後方互換性のためにプレフィックスのない sha1 ダイジェストとなっています。ペイロードは信頼できないものとして扱い、いずれかのフィールドが存在しない場合、Signature の形式が不正な場合、または比較が失敗した場合は、リクエストを拒否してください。
利用可能な場合は、当社の SDK の検証ヘルパーを使用してください。検証を自分で実装する場合は、HMAC を計算する前に解析済みの JSON を再シリアライズしないでください。空白とオブジェクトのキーの順序は、署名対象のバイト列の一部です。
import { createHmac, timingSafeEqual } from 'node:crypto'
// authSecret must come from trusted server-side configuration.
function verifyTransloaditWebhook({ authSecret, payload, signature }) {
if (typeof payload !== 'string' || typeof signature !== 'string') return false
if (!/^[0-9a-f]+$/.test(signature)) return false
const expected = createHmac('sha1', authSecret).update(payload, 'utf8').digest()
if (signature.length !== expected.length * 2) return false
const received = Buffer.from(signature, 'hex')
return received.length === expected.length && timingSafeEqual(received, expected)
}
より強力な Signature を有効にする
Auth Key を作成または更新する際に、notification_signature_algo を sha256 または sha384 に設定してください。この設定は、API リクエストへの署名を制御するキーの signature_algo とは独立しています。既存のキーと新しいキーのデフォルトは null です。更新時にこの設定を省略すると現在の設定が維持され、null に設定すると追加のヘッダーが無効になります。
この設定を有効にしたキーでは、sha256:<lowercase hex digest> または sha384:<lowercase hex digest> を含む
Transloadit-Signature ヘッダーが追加されます。従来の signature フォームフィールドは変更されません。両方の Signatures は、デコード済みの transloadit フォームフィールド内にある、フィルター適用後の正確な JSON 文字列の、URL エンコード前の UTF-8 バイト列を署名対象とします。エンコード済みの HTTP 本文に署名したり、検証前に JSON を解析して再シリアライズしたりしないでください。
初回の Notifications は、Assembly の認証時に読み込まれたキー設定を使用します。キーを変更しても、すでに進行中の Assemblies は変更されません。明示的な Notification の再送では、記録されたキーの現在のシークレットと Notification 用アルゴリズムを一緒に検索します。過去のキーの検索で上記のフォールバックが発生した場合は、呼び出し元の設定が一緒に使用されます。自動再試行では、その配信で選択されたアルゴリズムとシリアライズ済みのペイロードが維持されます。
新しいヘッダーを有効にする前に、そのヘッダーに対応した検証処理をデプロイしてください。連携側でより強力な Signature を必須にしたら、ヘッダーが存在しない場合や無効な場合は拒否し、検証処理に設定されたもの以外のアルゴリズムも拒否してください。SHA-1 フィールドに暗黙にフォールバックしてはいけません。移行時は、まずすべての Notification 送信側と再送ハンドラーをデプロイしてください。キー設定のキャッシュが更新され、以前の Assemblies が完了するのを待ち、変更後に作成された Assemblies の配信でヘッダーが届くことを確認してから、ヘッダーを必須にしてください。受信側でヘッダーを必須にした後は、送信側のロールフォワードを優先してください。受信側で従来方式のみの Notifications との互換性を先に復元しない限り、送信側を従来方式のみのビルドにロールバックすると、配信できなくなります。
import { createHmac, timingSafeEqual } from 'node:crypto'
// expectedAlgorithm and authSecret come from trusted server-side configuration.
function verifyStrongTransloaditWebhook({ authSecret, expectedAlgorithm, payload, signature }) {
if (expectedAlgorithm !== 'sha256' && expectedAlgorithm !== 'sha384') return false
if (typeof payload !== 'string' || typeof signature !== 'string') return false
const prefix = `${expectedAlgorithm}:`
if (!signature.startsWith(prefix)) return false
const hex = signature.slice(prefix.length)
if (!/^[0-9a-f]+$/.test(hex)) return false
const expected = createHmac(expectedAlgorithm, authSecret).update(payload, 'utf8').digest()
if (hex.length !== expected.length * 2) return false
return timingSafeEqual(Buffer.from(hex, 'hex'), expected)
}
Signature の検証はペイロードを認証しますが、重複配信を防ぐものではありません。検証済みの Assembly の識別情報とアプリケーション自身の状態を使用して、処理を冪等にしてください。
ウェブフックのフォームフィールド
完全な JSON スキーマ
Transloadit は、このオブジェクトについて記載されているフィールドのみを送信します。
| フィールド | 型と説明 |
|---|---|
signature必須 | stringtransloadit 文字列の正確なバイト列に対する HMAC-SHA1 を、アルゴリズムのプレフィックスなしで小文字の16進数として表記したものです。信頼できる Auth Secret を使用し、タイミングセーフな比較を行ってください。 検証パターン(正規表現)^[0-9a-f]{40}$ |
transloadit必須 | stringフィルタリング済みの Assembly Status の正確な JSON テキストです。JSON として解析する前に、この文字列を一切変更せず、その正確なバイト列を対象に Signature を検証してください。 |
検証済み JSON ペイロード
完全な JSON スキーマ
| フィールド | 型と説明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
account_id | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
account_name | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
account_slug | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
api_auth_key_id | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
assemblyId | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
assembly_id | stringこの Assembly の一意の ID です。Assembly が作成されたときにこの ID をデータベースに保存し、受信する Notifications との照合に使用できます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
assembly_ssl_url | null | stringこの Assembly の現在のステータスを照会するための一意の URL で、SSL/HTTPS 経由で使用できます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
assembly_url | null | stringこの Assembly の現在のステータスを照会するために使用する一意の URL。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
build_id | stringサポートによるトラブルシューティング用の、省略可能なビルド識別子です。不透明な値として扱ってください。Assemblies 間で変わる場合があります。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bytes_expected | numberこの Assembly でアップロードされると見込まれるバイト数。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bytes_received | numberこれまでにこの Assembly にアップロードされたバイト数です。これは主に、クライアントがアップロードの進行状況を表示するために使用します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bytes_usage | number | nullこの Assembly が処理したバイトのうち、利用料金の請求対象となるバイトの総数です。すべての Assemblies の | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
client_agent | null | stringアップローダーのユーザーエージェントは公開されません。この非推奨フィールドは常に | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
client_ip | null | stringアップロード元の IP アドレスは公開されません。この非推奨フィールドは常に | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
client_referer | null | stringアップローダーのリファラー URL は公開されません。この非推奨のフィールドは常に | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
companion_url | null | stringこの Assembly が通信できる Companion サーバーの URL。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
cron_input_file_limit | integer (最小値: 1, 最大値: 1000)スケジュールされた Assembly の入力ファイル数に対する実効上限。クラッシュからの自動復旧では、保存済みの Instructions が無効になっている場合も、この上限が維持されます。通常の Assemblies では、このフィールドは省略されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
executing_jobs | Array<string>配列要素のスキーマstring | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
execution_duration | number | nullTransloadit がこの Assembly の実行に要した時間(秒)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
execution_start | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
expected_tus_uploads | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fields | objectUppy など、 追加プロパティのスキーマ任意の値 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
finished_tus_uploads | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
has_dupe_jobs | boolean | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ignored_error_count | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ignored_errors | Array<object>配列要素のスキーマ
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
info |
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
info. | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
instance | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
is_infinite | boolean | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
jobs_queue_duration | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
last_job_completed | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
merged_params | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
message | stringこの Assembly の状態を説明する、人が読んで理解できるメッセージです。必ずしも含まれるとは限りません。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
notify_duration | number | null自動再試行とその間の待機時間を含む、配信にかかった時間(秒)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
notify_error | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
notify_response_code | number | null | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
notify_response_data | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
notify_start | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
notify_status | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
notify_url | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
num_input_files | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
params | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
parent_assembly_status | 任意の値 | null次のいずれかのスキーマが適用される場合があります: 任意の値任意の値null | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
parent_id | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
previousStep | stringエラーに関連する前の Step の名前(取得可能な場合)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
queue_duration | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
region | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
results | objectTransloadit がこれまでに生成した結果ファイルです。各キーは、ファイルを生成した Step の名前です。ストレージ Robots はファイルを生成しないため、それらの Step 名は省略されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
running_jobs | Array<string>配列要素のスキーマstring | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
start_date | stringこの Assembly のアップロードが開始された日時。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
started_jobs | Array<string>配列要素のスキーマstring | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
started_tus_uploads | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
step | stringエラーに関連付けられた Step の名前(取得可能な場合)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template_id | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
template_name | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
transloadit_client | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tus_uploads | Array<object>配列要素のスキーマ
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tus_url | stringこの Assembly が再開可能なアップロードに使用する tus サーバーの URL。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
update_stream_url | null | stringこの Assembly のステータス更新をリアルタイムで取得できる、サーバー送信イベントストリームの URL。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
upload_duration | numberアップローダーがファイルのアップロードに要した時間(秒)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
upload_meta_data_extracted | boolean | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
uploads | Array<object>この Assembly 用にアップロードされたファイルの配列です。詳細については、メタデータのドキュメントを参照してください。 配列要素のスキーマ
次のいずれかのスキーマが適用される場合があります: 必須プロパティ: basename, ext, field, id, mime, name, size, type, url: object
バリアント 2: object
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
uppyserver_url | null | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
usage_tags | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
virusname | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
warnings | Array<object>配列要素のスキーマ
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
websocket_url | null | stringこの Assembly のステータス更新をリアルタイムで取得できる Websocket(Socket.IO を使用)サーバーの URL。 |
次のいずれかのスキーマが適用される場合があります:
ok: "ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING"
Transloadit は追加のフィールドを送信することがあります。
| フィールド | 型と説明 |
|---|---|
error | なしエラーステータスを示します。このキーは、Assembly が失敗した場合にのみ存在します。新しいエラーコードが追加されることがあります。認識できないコードは失敗として処理し、プログラムで検査できるようにその値を保持してください。 この値は禁止されています。 |
ok必須 | "ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING"エラーではないライフサイクルのステータスを示し、アップロード中、実行中、中止済み、キャンセル済みの状態が含まれます。処理の成功は |
ok: string
Transloadit は追加のフィールドを送信することがあります。
| フィールド | 型と説明 |
|---|---|
error | なしエラーステータスを示します。このキーは、Assembly が失敗した場合にのみ存在します。新しいエラーコードが追加されることがあります。認識できないコードは失敗として処理し、プログラムで検査できるようにその値を保持してください。 この値は禁止されています。 |
ok必須 | stringエラーではないライフサイクルのステータスを示し、アップロード中、実行中、中止済み、キャンセル済みの状態が含まれます。処理の成功は 指定可能な値 (6)
|
必須プロパティ: error
Transloadit は追加のフィールドを送信することがあります。
| フィールド | 型と説明 |
|---|---|
cmd | string | Array<string | number>トラブルシューティング用の処理コマンドの詳細情報です(省略可能)。診断情報の詳細は異なる場合があります。プログラムによるエラー処理には 次のいずれかのスキーマが適用される場合があります: stringArray<string | number>Array<string | number>配列要素のスキーマstring | number |
error必須 | string (最小長: 1)エラーステータスを示します。このキーは、Assembly が失敗した場合にのみ存在します。新しいエラーコードが追加されることがあります。認識できないコードは失敗として処理し、プログラムで検査できるようにその値を保持してください。 既知の値(370)。その他の値もあり得ます
|
exitCode | number | null失敗した処理コマンドの終了ステータス(省略可能)。診断の詳細は異なる場合があります。プログラムによるエラー処理には |
exitSignal | null | string処理コマンドを終了させたシグナル(省略可能)。診断の詳細は異なる場合があります。プログラムによるエラー処理には |
file | string |
headers | object追加プロパティのスキーマ任意の値 |
is_private_address | boolean |
name | string |
numRetries | number |
ok | null |
playwright_error_code | string |
reason | null | string | number | boolean | Array<任意の値> | object省略可能な診断の詳細情報です。この値が文字列であると仮定したり、そのまま表示したりしないでください。人が読めるテキストには 次のいずれかのスキーマが適用される場合があります: nullstringnumberbooleanArray<任意の値>Array<任意の値>配列要素のスキーマ任意の値objectobject追加プロパティのスキーマ任意の値 |
response_code | number | null |
retries | number |
retryable | boolean |
stderr | stringトラブルシューティング用の、処理コマンドからの診断出力です(省略可能)。診断の詳細は変わる場合があります。プログラムによるエラー処理には |
stdout | stringトラブルシューティング用の、処理コマンドからの標準出力です(省略可能)。診断情報の詳細は異なる場合があります。プログラムによるエラー処理には |
url | string |
url_host | null | string |