再開可能なファイルアップロード用 Robot /tus/ store の紹介
最近続いている新機能の紹介として、今日も新しい Robot、/tus/store Robot を紹介します。/tus/store は、新しいエクスポート用 Robot です。tus プロトコルに対応する任意のサーバーにファイルをエクスポートでき、送信先へのアップロードを中断後に再開できます。

tus とは?
tus は、再開可能なファイルアップロードを実現する強力で堅牢なアップロードプロトコルです。中断にもスムーズに対応できるため、インターネット接続が低品質または不安定な環境に最適です。Supabase をはじめ、さまざまなプラットフォームで広くサポートされています。tus が提供するのは再開機能であり、転送自体のセキュリティではありません。転送のセキュリティは、HTTPS とエンドポイントの認証・認可によって決まります。
プロトコルの技術的な詳細や、サーバーに tus サポートを追加する方法を知りたい場合は、tus のウェブサイトをご覧ください。
/tus/store の使い方
さっそく試したい方に向けて、/tus/store Robot を使う Template を見ていきます。
以下のデモ用エンドポイントは使い捨てのため、機密ファイルを送信しないでください。本番環境では、endpoint を独自に設定した tus エンドポイントに置き換え、HTTPS と送信先で必要な認証・認可を使用してください。
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"resize": {
"use": ":original",
"robot": "/image/resize",
"width": "250",
"height": "250",
"resize_strategy": "fillcrop",
"result": true,
"imagemagick_stack": "v3.0.1"
},
"export": {
"use": [":original", "resize"],
"robot": "/tus/store",
"endpoint": "https://tusd.tusdemo.net/files/"
}
}
}
上記の Template では、まず画像をリサイズし、/tus/store Robot を使って tus のデモ用エンドポイントにエクスポートします。
このエンドポイントでは、リクエストに認証情報を含める必要がありません。ただし、常にそうとは限らず、送信先サーバーでファイルの送信元に関する追加情報が必要な場合もあります。エンドポイントで認証情報が必要な場合は、credentials パラメーターを使ってリクエストに含められます。認証情報は、ほかのエクスポート用
Robot と同じ方法で作成できます。
まず、Template の認証情報ページに移動し、サードパーティー用の認証情報を新しく作成します。
サービスとして HTTP/HTTPS を選択し、認証情報に覚えやすい名前を付けます。続いて「ヘッダー」セクションに、アップロードの実行時に送信先で必要となる値を追加できます。以下のスクリーンショットのような設定になります。

これで、/tus/store Robot を使い始めるための準備が整いました。この Robot で利用できるすべての機能については、ドキュメントをご覧ください。
