cURL
Nous ne recommandons pas d’utiliser l’intégration cURL en production, mais elle peut être pratique pour un test rapide lorsque vous n’avez pas de SDK sous la main.
Installer
brew install curl jq || sudo apt install curl jq
Exemple
L’en-tête Transloadit-Client identifie cURL et sa version installée pour faciliter le débogage.
(
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
)
Requête signée
Lorsque Signature Authentication est obligatoire, chaque requête doit
inclure une signature correspondant exactement à ses
params. La CLI transloadit, fournie avec
@transloadit/node, ajoute votre Auth Key et une date d’expiration, puis affiche
params signé et sa signature.
Elle lit vos informations d’authentification dans l’environnement.
Ces exemples de signature utilisent SHA-256, accepté par les Auth Keys pour lesquelles la signature Smart CDN est activée. Si votre Auth Key utilise un autre algorithme de Signature, adaptez-le dans --algorithm, ainsi que l’algorithme de hachage OpenSSL et le préfixe de la signature.
(
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
)
Sans Node.js, calculez la même signature avec OpenSSL : un HMAC-SHA256 de la chaîne
params exacte, avec votre Auth Secret comme clé.
(
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
)
Envoyez params comme champ de formulaire, comme dans ces exemples.
L’API n’accepte pas de corps de requête JSON.