Como usar a TLCDN?

A rede de distribuição de conteúdo da Transloadit (TLCDN) é um Smart CDN que permite transformar dinamicamente e entregar seus arquivos de mídia, como imagens, vídeos e documentos, em tempo real. Veja como usar a TLCDN:

Hospedar seus arquivos

Armazene seus arquivos originais na sua própria solução de armazenamento em nuvem, como um bucket do Amazon S3.

Criar um Template

Crie um Template da Transloadit que defina as instruções de importação, transcodificação e entrega dos seus arquivos de mídia. Esse Template pode incluir vários Robots (por exemplo, /image/resize, /document/convert) e suas respectivas configurações. Incluímos abaixo um Template básico de transformação de imagens.

{
  "steps": {
    "imported": {
      "robot": "/s3/import",
      "credentials": "my-s3-credentials",
      "path": "/images/${fields.input}"
    },
    "resized": {
      "use": "imported",
      "robot": "/image/resize",
      "width": "${fields.w}"
    },
    "served": {
      "use": "resized",
      "robot": "/file/serve"
    }
  }
}

No seu Template, você pode usar Assembly Variables (por exemplo, ${fields.w}) para ajustar as configurações de transformação com base nos parâmetros de consulta passados pela URL da TLCDN.

Solicitar transformações

Para solicitar uma transformação, monte uma URL da TLCDN usando o seguinte formato:

https://[your-workspace].tlcdn.com/[template-name]/[file-path]?[parameters]

Quando um usuário solicitar essa URL, a TLCDN buscará o arquivo original no seu armazenamento em nuvem, aplicará as transformações especificadas no seu Template (usando os parâmetros fornecidos) e entregará o arquivo transformado.

Lembre-se de substituir:

• your-workspace pelo nome do seu Workspace na Transloadit
• template-name pelo nome do seu Template
• file-path pelo caminho do arquivo que você quer transformar
• parameters pelos parâmetros de transformação desejados (por exemplo, ?w=730 para definir a largura como 730 pixels)

Opcionalmente, você pode acrescentar à URL um prazo de expiração e uma assinatura para impedir que terceiros adulterem a URL e seus parâmetros. Para saber mais sobre como gerar uma assinatura com o hash correto, consulte nosso guia detalhado.

Com tudo configurado, você poderá obter transformações tão rápidas quanto as da demonstração abaixo.

my-app.tlcdn.com/resize-img/canoe.jpg?w=550

Ajustar a largura da imagem (atualmente 550 px)

Carregando pré-visualização…