cURL
No recomendaríamos usar la integración de cURL en producción, pero puede ser útil para hacer una prueba rápida cuando no tienes un SDK a mano.
Instala
brew install curl jq || sudo apt install curl jq
Ejemplo
El encabezado Transloadit-Client identifica cURL y su versión instalada para facilitar
la depuración.
(
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
)
Solicitud firmada
Cuando se exige Signature Authentication, cada solicitud necesita
una signature para su valor exacto de params.
La CLI transloadit, que se distribuye con @transloadit/node,
añade tu Auth Key y una fecha de caducidad, y luego imprime el valor firmado de
params y su signature.
Esta CLI lee tus credenciales desde el entorno.
Estos ejemplos de firma usan SHA-256, que aceptan las Auth Keys con la firma de Smart CDN habilitada. Si tu Auth Key usa otro algoritmo de firma, haz que coincidan su configuración en --algorithm, el resumen de OpenSSL y el prefijo de la firma.
(
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
)
Sin Node.js, calcula la misma firma con OpenSSL: un HMAC-SHA256 de la cadena exacta
params, usando tu Auth Secret como clave.
(
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
)
Envía params como un campo de formulario, tal como hacen estos ejemplos.
La API no acepta un cuerpo de solicitud JSON.