Criar um token bearer

Troca as credenciais da Auth Key por um bearer token com escopo definido.

Este endpoint troca sua Auth Key e seu Auth Secret por um token Bearer de curta duração. Ele espelha o fluxo client_credentials do OAuth 2.0, mas é tratado diretamente pela API da Transloadit.

Os tokens são emitidos no lado do servidor por meio deste endpoint, usando sua Auth Key/Secret. Se você expuser a criação de tokens por uma interface, chame /token a partir do seu backend (nunca diretamente do navegador).

Workspaces cancelados não podem criar novos tokens bearer. Para endpoints cuja documentação permite explicitamente leituras após o cancelamento, use a receita de leitura assinada com uma Auth Key ativa já existente. O faturamento tem sua própria receita de faturamento assinada.

As requisições devem usar application/x-www-form-urlencoded e HTTP Basic Auth:

Em um shell confiável no lado do servidor, com curl e jq, defina TRANSLOADIT_KEY e TRANSLOADIT_SECRET com sua Auth Key e seu Auth Secret. Mantenha as duas credenciais e o token resultante em segredo; nunca execute essa configuração em código de navegador.

Este exemplo solicita acesso de leitura/escrita a Assemblies e salva o access_token retornado como TRANSLOADIT_TOKEN para as requisições seguintes no mesmo shell. Para outro endpoint, use os escopos listados nele; a Auth Key já precisa concedê-los. Endpoints autenticados por uma Auth Key ou por um token bearer incluem a configuração de token apropriada em seus exemplos de requisição.

if ! TOKEN_RESPONSE="$(curl --fail-with-body -sS \
  --request POST \
  --url 'https://api2.transloadit.com/token' \
  --user "${TRANSLOADIT_KEY:?Set TRANSLOADIT_KEY}:${TRANSLOADIT_SECRET:?Set TRANSLOADIT_SECRET}" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'aud=api2' \
  --data-urlencode 'scope=assemblies:read assemblies:write')"; then
  printf '%s\n' "$TOKEN_RESPONSE" >&2
  exit 1
fi
TRANSLOADIT_TOKEN="$(printf '%s' "$TOKEN_RESPONSE" |
  jq -er '.access_token | strings | select(length > 0)')" || exit 1

Este endpoint usa autenticação HTTP Basic com sua Auth Key e seu segredo.

Tipo de conteúdo: application/x-www-form-urlencoded

Os seguintes campos podem ser enviados no máximo uma vez: aud, grant_type, scope.

Usando o token

Envie o token como Authorization: Bearer <access_token> nas requisições à API. Quando uma requisição é autenticada com um Bearer token válido, a API2 considera a Signature Authentication como satisfeita e pula a validação da assinatura. A Signature Authentication só é exigida em requisições com chave/segredo. As verificações de escopo continuam valendo. A audiência padrão api2 é aceita pelos endpoints comuns da API2 e é válida por 21.600 segundos por padrão. A audiência mcp é aceita pelo servidor MCP, rejeitada pelos endpoints comuns da API2 e válida por 604.800 segundos por padrão. Trate o valor expires_in da resposta como a fonte autoritativa.