cURL
cURL 連携を本番環境で使用することはお勧めしませんが、SDK が手元にない場合の簡単なテストには便利です。
インストール
brew install curl jq || sudo apt install curl jq
使用例
Transloadit-Client ヘッダーは、デバッグに役立つように、cURL とそのインストール済みバージョンを識別します。
(
set -euo pipefail
# Prerequisites: brew install curl jq || sudo apt install curl jq
# To avoid tampering, use Signature Authentication
echo '{
"template_id": "YOUR_TEMPLATE_ID",
"auth": {
"key": "YOUR_TRANSLOADIT_KEY"
},
"steps": {}
}' | curl --fail \
--request POST \
--header "Transloadit-Client: curl:$(curl --version | awk 'NR == 1 {print $2}')" \
--form 'params=<-' \
--form myfile1=@./joe-gardner-149699.jpg \
https://api2.transloadit.com/assemblies | jq
)
署名付きリクエスト
Signature Authentication が必須の場合、すべてのリクエストに signature が必要です。これは、そのリクエストの params と完全に一致する内容に対する署名です。transloadit CLI は @transloadit/node に同梱されており、Auth Key と有効期限を追加して、署名済みの params とその signature を出力します。認証情報は環境変数から読み取ります。
これらの署名例では、Smart CDN 署名が有効な Auth Key で受け付けられる SHA-256 を使用します。Auth Key が別の Signature アルゴリズムを使用する場合は、--algorithm、OpenSSL のダイジェスト、署名プレフィックスをそのアルゴリズムに合わせてください。
(
set -euo pipefail
export TRANSLOADIT_KEY="YOUR_TRANSLOADIT_KEY"
export TRANSLOADIT_SECRET="YOUR_TRANSLOADIT_SECRET"
signed=$(echo '{"template_id": "YOUR_TEMPLATE_ID"}' | npx -y @transloadit/node signature --algorithm sha256)
curl --fail \
--request POST \
--form-string "params=$(jq -r .params <<<"$signed")" \
--form-string "signature=$(jq -r .signature <<<"$signed")" \
--form myfile1=@./joe-gardner-149699.jpg \
https://api2.transloadit.com/assemblies | jq
)
Node.js を使用しない場合は、OpenSSL で同じ署名を計算します。Auth Secret をキーとして、params の文字列を一切変更せずに
HMAC-SHA256 を計算します。
(
set -euo pipefail
export TRANSLOADIT_KEY="YOUR_TRANSLOADIT_KEY"
export TRANSLOADIT_SECRET="YOUR_TRANSLOADIT_SECRET"
# One hour from now, in UTC (BSD/macOS date first, then GNU date)
format='%Y/%m/%d %H:%M:%S+00:00'
expires=$(date -u -v+1H "+$format" 2>/dev/null || date -u -d '+1 hour' "+$format")
params=$(jq -nc --arg key "$TRANSLOADIT_KEY" --arg expires "$expires" \
'{auth: {key: $key, expires: $expires}, template_id: "YOUR_TEMPLATE_ID"}')
hmac=$(printf '%s' "$params" \
| openssl dgst -sha256 -hmac "$TRANSLOADIT_SECRET" | awk '{print $NF}')
signature="sha256:$hmac"
curl --fail \
--request POST \
--form-string "params=$params" \
--form-string "signature=$signature" \
--form myfile1=@./joe-gardner-149699.jpg \
https://api2.transloadit.com/assemblies | jq
)
これらの例と同様に、params をフォームフィールドとして送信してください。API は JSON リクエストボディを受け付けません。