Asset upload

Schema preview: このページの手順は公開契約のpreviewです。stg live acceptanceが完了するまで、 API keyの発行とdirect / multipart upload operationの実行は利用できません。

Direct upload

direct upload は、Asset upload の登録、発行された URL への媒体送信、confirm の3段階です。 媒体本体を lifecycle API の JSON body へ含めません。

1. ContentSpace に Asset upload を登録します。
2. response の upload URL へ指定された method と header で媒体を送ります。
3. upload を confirm し、検証結果または非同期 Run を受け取ります。

upload URL は credential と同様に扱い、有効期限内でも log や第三者へ共有しないでください。

Multipart upload

大容量媒体は multipart upload を登録し、part ごとの URL を発行します。

1. multipart upload session を登録します。
2. 必要な part 番号の upload URL を発行します。
3. 各 part を送信し、checksum と識別子を保持します。
4. 完了した part の一覧を送って complete します。
5. 失敗または不要になった session は cancel します。

part の順序、checksum、最小・最大 size は API Reference の schema に従ってください。

再試行

URL の期限切れと upload body の再送を区別します。create / complete request は同じ Idempotency-Key と同じ正規化済み request で再試行し、意味の異なる request に key を再利用しません。