cURL
Wir empfehlen die cURL-Integration nicht für den Produktionseinsatz. Für einen schnellen Test ohne verfügbares SDK kann sie jedoch praktisch sein.
Installation
brew install curl jq || sudo apt install curl jq
Beispiel
Der Header Transloadit-Client identifiziert cURL und die installierte Version, um die
Fehlersuche zu erleichtern.
(
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
)
Signierte Anfrage
Wenn Signature Authentication erforderlich ist, braucht jede Anfrage
eine signature für ihre exakten params.
Die CLI transloadit, die mit @transloadit/node geliefert wird,
ergänzt Ihren Auth Key und ein Ablaufdatum und gibt dann die signierten
params und ihre signature aus. Ihre Zugangsdaten liest
sie aus der Umgebung.
Diese Signierbeispiele verwenden SHA-256, das Auth Keys mit aktivierter Smart-CDN-Signierung akzeptieren. Wenn Ihr Auth Key einen anderen Signaturalgorithmus verwendet, passen Sie ihn in --algorithm, im OpenSSL-Digest und im Signaturpräfix entsprechend an.
(
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
)
Ohne Node.js berechnen Sie dieselbe Signatur mit OpenSSL: ein HMAC-SHA256 des exakten Strings
params, mit Ihrem Auth Secret als Schlüssel.
(
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
)
Senden Sie params wie in diesen Beispielen als Formularfeld. Die API
akzeptiert keinen JSON-Anfragekörper.