cURL
Não recomendamos usar a integração com cURL em produção, mas ela pode ser útil para um teste rápido quando você não tem um SDK à mão.
Instalar
brew install curl jq || sudo apt install curl jq
Exemplo
O cabeçalho Transloadit-Client identifica o cURL e a versão instalada para ajudar na depuração.
(
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
)
Requisição assinada
Quando a Signature Authentication é obrigatória, cada requisição
precisa de uma signature para seus params exatos.
A CLI transloadit, incluída no @transloadit/node, adiciona sua
Auth Key e uma data de expiração e depois imprime os params assinados
e sua signature. Ela lê suas credenciais do ambiente.
Estes exemplos de assinatura usam SHA-256, que as Auth Keys com a assinatura da Smart CDN habilitada aceitam. Se sua Auth Key usa outro algoritmo de assinatura, ajuste-o em --algorithm, assim como o digest do OpenSSL e o prefixo da assinatura.
(
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
)
Sem Node.js, calcule a mesma assinatura com o OpenSSL: um HMAC-SHA256 da string
params exata, usando seu Auth Secret como chave.
(
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
)
Envie params como campo de formulário, como estes exemplos fazem. A API não aceita um corpo de requisição JSON.