Transloadit
Preços
  • Uploads de arquivos
  • Importação de arquivos
  • Processamento em lote (English)
  • Codificação de vídeo
  • Codificação de áudio
  • Processamento de imagens
  • Processamento de documentos
  • Inteligência artificial
  • Filtragem de arquivos e segurança
  • Catalogação de mídia
  • Compressão de arquivos
  • Avaliação de código
  • Exportação de arquivos
  • Smart CDN
  • Ver todos os serviços
  • Explore integrações (English)
  • Explore demos ao vivo (English)
  • Uppy (English)
  • TransloaditKit (English)
  • Android SDK (English)
  • Node.js SDK (English)
  • Python SDK (English)
  • Ruby SDK (English)
  • Go SDK (English)
  • Java SDK (English)
  • PHP SDK (English)
  • Zapier (English)
  • MCP Server (English)
  • Transloadit CLI (English)
  • Terraform (English)
  • Essenciais
  • Boas práticas
  • Perguntas frequentes (English)
  • Robots (English)
  • API
  • Formatos (English)
  • Crie seu primeiro app
  • Sobre (English)
  • Comparações (English)
  • Código aberto (English)
  • Depoimentos (English)
  • Vagas (English)
  • Segurança (English)
  • Publicações (English)
  • Notícias para devs (English)
  • Dicas para devs (English)
  • Imprensa (English)
  • Pesquisa (English)
  • Estudos de caso (English)
  • Soluções (English)
  • Guias (English)
  • Glossário (English)
  • Jurídico (English)
  • Ferramentas (English)
  • Ajudando a Coursera a levar educação a milhões de pessoas no mundo todo (English)
  • Suporte da Transloadit
  • Suporte a código aberto (English)
  • Acordo de nível de serviço (English)
EssenciaisRobotsEN (English)Perguntas frequentesEN (English)APIFormatosEN (English)Boas práticas
Tópicos
  • Endpoints
  • Códigos de resposta
  • Autenticação
  • Webhooks
  • Metadados
  • Segurança da API
  • Limite de taxa
  • Filas
  • Uploads retomáveis
Autenticação
  • Criar um token bearer
  • Criar uma nova Auth Key
  • Recuperar lista de Auth Keys
  • Recuperar escopos da Auth Key
  • Editar uma Auth Key
  • Excluir uma Auth Key
  • Recuperar o segredo de uma Auth Key
Assemblies
  • Criar uma nova Assembly
  • Obter um Assembly Status
  • Criar uma Assembly com um ID fornecido
  • Transmitir alterações da Assembly em tempo real
  • Cancelar uma Assembly em execução
  • Reexecutar uma Assembly
  • Recuperar lista de Assemblies
  • Resposta do Assembly Status
  • Recuperar estatísticas de Assemblies
Webhooks
  • Recuperar Assembly Notifications
  • Reenviar Assembly Notification
Faturamento
  • Obter a fatura de um mês
Filas
  • Obter as vagas prioritárias de Jobs em uso no momento
  • Obter estatísticas de vagas prioritárias de Job
Uploads retomáveis
  • Descobrir os recursos do tus
  • Criar um upload tus
  • Obter o offset de um upload tus
  • Enviar bytes de arquivo tus
  • Encerrar um upload tus
  • Baixar um upload tus
Credenciais de Template
  • Criar uma nova credencial de Template
  • Recuperar uma credencial de Template
  • Editar uma credencial de Template
  • Excluir uma credencial de Template
  • Obter lista de credenciais de Template
  • Recuperar tipos de credenciais de Template
Templates
  • Criar um novo Template
  • Recuperar um Template
  • Editar um Template
  • Excluir um Template
  • Recuperar lista de Templates
Gerenciamento de Ativos Digitais
  • Mover ou renomear um ativo de DAM alpha
  • Excluir um ativo do DAM alpha
  • Mover ativos do DAM em massa alpha
  • Excluir ativos do DAM em massa alpha
  • Mover um arquivo ou uma pasta de armazenamento alpha
  • Obter um ativo de armazenamento
  • Listar ativos de armazenamento

Criar uma Assembly com um ID fornecido

Cria uma Assembly em um Assembly ID novo, escolhido pelo chamador.

PUThttps://api2.transloadit.com/assemblies/{assemblyId}

Cria uma Assembly usando um ID novo fornecido por quem faz a chamada. Isso não substitui uma Assembly existente. Você nunca deve reutilizar um Assembly ID, inclusive depois que uma Assembly tiver expirado ou sido excluída. Um conflito com um ID ativo pode retornar ASSEMBLY_COULD_NOT_BE_CREATED; um uso anterior registrado pode retornar DO_NOT_REUSE_ASSEMBLY_IDS. Essas verificações não são uma garantia permanente de deduplicação. Este endpoint não é um mecanismo de repetição idempotente.

Fluxo de trabalho típico:

  1. Envie o exemplo de requisição abaixo com seu arquivo e as Instructions de processamento. Para receber o status final por meio de um webhook, inclua notify_url nessas Instructions antes de enviar a requisição.
  2. Mantenha em segredo a assembly_ssl_url retornada. Use-a para verificar o progresso, ou aguarde o webhook que você configurou.
  3. Aguarde ok: "ASSEMBLY_COMPLETED" antes de consumir os arquivos processados. Um error ou um cancelamento não é processamento bem-sucedido. Os arquivos de saída são agrupados pelo nome do Step em results; consulte os campos da resposta.

Assemblies que usam /transloadit/import, diretamente ou por meio de um Template, exigem um bearer token ou params assinados com um timestamp params.auth.expires no futuro. Isso vale mesmo quando a Signature Authentication do Workspace está desativada. Uma Auth Key sozinha não é suficiente; requisições autenticadas por bearer token não precisam de assinatura nem de expiração separadas.

Use Reexecutar uma Assembly para tentar processar novamente entradas recuperáveis como uma nova Assembly, ou Cancelar uma Assembly para interromper uma existente.

Exemplo de requisição

A requisição abaixo usa openssl para gerar um Assembly ID novo e imprevisível. Gere um novo ID para cada requisição; nunca reutilize um.

Execute esta requisição em um shell no servidor com curl e um bearer token adequado em TRANSLOADIT_TOKEN. Se você precisar de um token, expanda a configuração abaixo.

Coloque seu arquivo de entrada em ./example.jpg antes de executar a requisição.

Precisa de um bearer token?

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

Primeiro, crie um token com os escopos exigidos por este endpoint. Sua Auth Key já precisa conceder esses escopos.

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: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

Mantenha este shell aberto e execute a requisição abaixo. Reutilize o token enquanto ele continuar válido.

ASSEMBLY_ID="$(openssl rand -hex 16)" || exit 1

curl --fail-with-body -sS --request PUT \
  --url "https://api2.transloadit.com/assemblies/${ASSEMBLY_ID:?Set ASSEMBLY_ID}" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --form-string 'params={"steps":{"resize":{"robot":"/image/resize","use":":original","width":320}}}' \
  --form 'file=@./example.jpg'

O que acontece em seguida

Uma resposta HTTP bem-sucedida aceita a Assembly; isso não significa que o processamento terminou. Uma resposta inicial pode ter esta aparência (trecho; os IDs e as URLs serão diferentes):

{
  "ok": "ASSEMBLY_EXECUTING",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_ssl_url": "https://api2-morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "results": {}
}

Copie assembly_ssl_url da sua resposta e verifique o status dela a cada poucos segundos, ou use um webhook configurado antes da criação. Mantenha essa URL em segredo. Pare quando houver um error ou um cancelamento; nenhum dos dois é processamento bem-sucedido.

Quando ok for ASSEMBLY_COMPLETED, a saída deste exemplo está em results.resize. Uma resposta concluída inclui os seguintes campos (trecho; a URL de saída é ilustrativa):

{
  "ok": "ASSEMBLY_COMPLETED",
  "message": "The Assembly was successfully completed.",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "results": {
    "resize": [
      {
        "name": "example.jpg",
        "mime": "image/jpeg",
        "ssl_url": "https://example.com/temporary-output/example.jpg",
        "meta": {
          "width": 320
        }
      }
    ]
  }
}

Use results.resize[0].ssl_url para baixar a imagem redimensionada. Essas URLs temporárias de saída expiram; adicione um Step de exportação como /s3/store EN (English) se você precisar manter os arquivos.

Autenticação

Este endpoint aceita params assinados ou um token bearer. Consulte Autenticação para instruções de configuração.

Escopo necessário para a Auth Key ou o token bearer: assemblies:write.

Requisições autenticadas por chave exigem uma assinatura quando a Signature Authentication está habilitada. Tokens Bearer não exigem uma assinatura separada.

Parâmetros de caminho

  • assemblyId (segmento de caminho), obrigatório. padrão: ^[a-z0-9]{32}$

Parâmetros de consulta opcionais da resposta

  • callback (Nome do callback JavaScript). Envolve respostas JSON em um callback JSONP. O nome do callback deve corresponder a ^(?:_jqjsp[0-9]*|jQuery[0-9]+_[0-9]+)$. Apenas a última ocorrência é usada; um valor vazio é ignorado. Nomes de callback inválidos retornam HTTP 403. A resposta transformada usa HTTP 200. O callback é aplicado após a serialização da resposta.

Campos de formulário multipart

Tipo de conteúdo: multipart/form-data

  • params (string JSON), obrigatório. Um objeto codificado em JSON cujas chaves suportadas estão listadas abaixo.

  • signature (string). Obrigatório quando a requisição usa Signature Authentication.

  • num_expected_upload_files (campo de formulário). Ao usar uploads retomáveis, especifica o número de arquivos que serão enviados. Mais detalhes são fornecidos em Uploads retomáveis.

  • tus_num_expected_upload_files (campo de formulário). Alias legado de num_expected_upload_files, mantido para compatibilidade com SDKs mais antigos.

  • * (binário ou string). Arquivos binários e campos adicionais da Assembly podem usar nomes de campo arbitrários.

Chaves compatíveis dentro do campo params

Os campos de autenticação desta lista se aplicam a requisições assinadas. Com um bearer token, você pode omitir params.auth e o campo signature separado. Compare os parâmetros de requisição específicos de autenticação abaixo.

Esquema JSON completo

Abrir JSON em uma nova aba

Parâmetros assinados usados para criar uma Assembly a partir de Steps diretos ou de um Template.

CampoTipo e descrição
params.auth

obrigatório para requisições assinadas; opcional com um bearer token

object

Metadados de autenticação e restrições de upload para uma solicitação assinada de Assembly. A chave de API é obrigatória.

Contém pelo menos sua Auth Key da Transloadit na propriedade key.

Se você habilitar Signature Authentication, também deverá definir uma data de expiração para a solicitação na propriedade expires:

{
  "key": "23c96d084c744219a2ce156772ec3211",
  "expires": "YOUR_FUTURE_ISO_8601_TIMESTAMP"
}

Recomendamos fortemente incluir uma propriedade nonce gerada aleatoriamente, um valor exclusivo por solicitação que torna distintas as assinaturas geradas de forma independente, ajuda na depuração e evita a reutilização acidental de assinaturas. Um nonce não torna as novas tentativas idempotentes: repetir uma solicitação de criação de Assembly pode criar outra Assembly. Trate a deduplicação de novas tentativas na sua aplicação quando necessário. Não reutilize params assinados entre endpoints. As leituras de Templates, a listagem de Auth Keys, a listagem de credenciais de Templates e as leituras de faturamento rejeitam assinaturas já registradas para um endpoint diferente ou usadas para criar uma Assembly, com SIGNATURE_REUSE_DETECTED. Gere novos params assinados para cada solicitação.

{
  // …
  "nonce": "04ac6cb6-df43-41fb-a7fd-e5dd711a64e1"
}

A propriedade referer é uma expressão regular a ser comparada com o referer HTTP deste upload, como "example\.org". Use-a para verificar se os valores de Referer fornecidos correspondem a um domínio esperado.

Uploads sem referer sempre passarão na verificação (pois ele é desativado em alguns navegadores), o que torna essa verificação útil em apenas alguns casos de uso. Para obter detalhes sobre expressões regulares, consulte a documentação de RegExp da Mozilla⁠.

Expressões regulares inválidas e expressões que excedem o limite de tempo de avaliação são rejeitadas. Essa verificação não substitui Signature Authentication: os clientes podem omitir ou falsificar o cabeçalho Referer.

A propriedade max_size limita o tamanho total esperado de upload da Assembly em bytes, como 1048576 (1 MB), em vez de limitar cada arquivo separadamente. Isso inclui o corpo da solicitação multipart ou os bytes da solicitação inicial da Assembly somados aos de seus uploads retomáveis. Exceder o limite interrompe toda a Assembly com um erro, incluindo arquivos que, individualmente, estão dentro do limite. Não dependa desse limite para rejeitar toda transferência acima do tamanho permitido antes que ela comece. Para uploads retomáveis, o tamanho declarado ou recebido fica disponível por meio de atualizações do tus, e a Assembly verifica o limite quando um upload concluído é processado. O tamanho de um upload adiado não é conhecido no momento da criação, e bytes podem já ter sido transferidos antes que a Assembly o rejeite. Se você quiser apenas ignorar os arquivos que excedem um determinado tamanho, mas processar todos os demais, use 🤖/file/filter EN (English).

A propriedade max_number_of_files pode ser usada para definir o número máximo de arquivos que um upload pode conter, como 100. Especifique essa propriedade para impedir que os usuários enviem uma quantidade excessiva de arquivos, tanto por uploads de arquivos quanto por Robots de importação.

Essas propriedades podem ser definidas como parte da solicitação de Assembly ou como parte do Template.

params.auth: Somente os campos listados para este objeto são aceitos.

params.auth.expires
string

Timestamp de expiração no formato ISO 8601 situado no futuro. Obrigatório quando uma requisição é assinada ou exige autenticação por assinatura; requisições autenticadas por bearer podem omiti-lo.

params.auth.key

obrigatório

string

Chave de API da Transloadit usada para autenticar as requisições

params.auth.max_number_of_files
integer (mínimo: 1)

Número máximo de arquivos de entrada permitidos por Assembly. Se o número de arquivos enviados ou importados exceder esse limite, a Assembly será interrompida com um erro. Isso é útil para evitar abusos quando as credenciais de Signature Authentication ficam expostas.

params.auth.max_size
number

Tamanho total máximo esperado de upload, em bytes, para a Assembly, incluindo a sobrecarga do corpo da requisição. Esse não é um limite por arquivo e não garante a rejeição antes do início de uma transferência retomável.

params.auth.nonce
string | integer

Valor único e aleatório incluído nos parâmetros da requisição assinada para tornar cada assinatura única e evitar a reutilização acidental de assinaturas.

params.auth.referer
string

Expressão regular usada para verificar a correspondência com um HTTP Referer fornecido. Expressões inválidas e expressões que excedem o limite de tempo de avaliação são rejeitadas. Requisições sem o cabeçalho Referer são aprovadas nessa verificação; use Signature Authentication para autenticar requisições.

params.emit_execution_progress
boolean

Defina como true para publicar eventos de Assembly Execution Progress em tempo real. Isso é ignorado para Assemblies de URL Transform.

params.exiftool_stack
string

Seleciona o stack do ExifTool para extração de metadados nesta Assembly. Isso não seleciona o stack de processamento para Steps de Robot.

params.ffmpeg_stack
string

Seleciona o stack do FFmpeg para a extração de metadados nesta Assembly. Isso não seleciona o stack de processamento dos Robot Steps. Defina ffmpeg_stack no Robot Step correspondente para selecionar o stack de processamento dele.

params.fields
object

Um objeto de valores com chaves em string (nome -> valor) que podem ser usados como Assembly Variables, assim como campos de formulário adicionais também podem. Você pode usar como valor qualquer coisa que seja convertível para string JSON

Esquema de propriedade adicional
qualquer valor
params.imagemagick_stack
string

Seleciona o stack do ImageMagick para a extração de metadados nesta Assembly. Isso não seleciona o stack de processamento dos Robot Steps. Defina imagemagick_stack no Robot Step correspondente para selecionar o stack de processamento dele.

params.mediainfo_stack
string

Seleciona o stack do MediaInfo para extração de metadados nesta Assembly. Isso não seleciona o stack de processamento dos Steps de Robot.

params.mplayer_stack
string

Seleciona o stack do MPlayer para extração de metadados nesta Assembly. Isso não seleciona o stack de processamento para Steps de Robot.

params.nonce
string | number

Valor único e aleatório incluído nos parâmetros da requisição assinada para tornar cada assinatura única e evitar a reutilização acidental de assinaturas.

params.notification_payload
Array<"without_params" | "without_result_meta_data" | "without_results" | "without_upload_meta_data" | "without_uploads">

Controla o tamanho do payload enviado nas Assembly Notifications. Os replays de Notification reutilizam os filtros informados na requisição original da Assembly; filtros definidos apenas em um Template não são preservados no replay. Um array vazio (padrão) envia o Assembly Status completo. Adicione "without_params" para que os campos brutos de Assembly Instructions de nível superior params, template e merged_params sejam omitidos. Adicione "without_result_meta_data" para que meta seja omitido de cada arquivo em results. Adicione "without_results" para que o objeto results de nível superior seja omitido. Adicione "without_upload_meta_data" para que meta seja omitido de cada arquivo em uploads. Adicione "without_uploads" para que o array uploads de nível superior seja omitido. A filtragem é aplicada antes da serialização, portanto usar essas opções reduz o uso de memória e ajuda a evitar falhas por payload grande demais ou por OOM em Assemblies grandes.

Esquema do item do array
"without_params" | "without_result_meta_data" | "without_results" | "without_upload_meta_data" | "without_uploads"
params.notify_url
null | string

A Transloadit pode enviar um Pingback para o seu servidor quando a Assembly for concluída. Enviaremos o Assembly Status como uma string JSON no campo transloadit de uma requisição POST application/x-www-form-urlencoded para a URL informada aqui. Use notification_payload para reduzir o tamanho do payload (por exemplo, without_uploads, without_results, without_params). Os replays de Notification reutilizam apenas os filtros informados na requisição original da Assembly, não os filtros definidos somente em um Template.

params.quiet
boolean

Defina isto como true para minimizar a resposta inicial de criação da Assembly. Uma resposta bem-sucedida inclui apenas ok e assembly_id; uma resposta de erro mantém error, http_code, message, reason e assembly_id quando disponível. Isso é minimização de resposta, não controle de acesso: qualquer pessoa que tenha o Assembly ID retornado ainda consegue obter o Assembly Status completo, incluindo campos e resultados, sem autenticação adicional. Trate Assembly IDs e URLs de status como capacidades secretas. O Assembly Status completo continua sendo enviado para notify_url quando configurado.

params.redirect_url
string

URL para a qual um upload de navegador é redirecionado após a conclusão do upload. O Assembly ID e a URL de status são anexados como parâmetros de consulta, preservando os parâmetros de consulta e o fragmento já existentes.

params.response_headers
object

Cabeçalhos de resposta personalizados emitidos por uma Assembly. Sobrescritas de CORS pertencem a cors; outras chaves de nível superior são emitidas como cabeçalhos personalizados.

params.response_headers: Campos além dos listados para este objeto são aceitos.

params.response_headers.cors
object

Detalhes adicionais do esquema estão disponíveis no JSON Schema completo.

params.usage_tags
string

Tags de uso registradas em uma Assembly.

Qualquer um dos esquemas a seguir pode ser aplicado:

propriedades obrigatórias: steps, template_id

Parâmetros usados para criar uma Assembly a partir de Steps diretos ou de um Template.

params: Somente os campos listados para este objeto são aceitos.

CampoTipo e descrição
params.steps

obrigatório

object

Valores parciais de Step mesclados nos Steps nomeados do Template armazenado. Seu formato completo, específico de cada Robot, é validado depois que o Template é carregado.

Esquema de propriedade adicional
object

Detalhes adicionais do esquema estão disponíveis no JSON Schema completo.

params.template_id

obrigatório

string (comprimento mínimo: 1)

O ID do Template que contém suas Assembly Instructions. Se você definir allow_steps_override como false no seu Template, então steps e template_id serão mutuamente exclusivos: você pode fornecer apenas um desses parâmetros.

Variante 2

Parâmetros usados para criar uma Assembly a partir de Steps diretos ou de um Template.

params: Somente os campos listados para este objeto são aceitos.

CampoTipo e descrição
params.steps
object

Contém as Assembly Instructions.

Esquema de propriedade adicional
object

Detalhes adicionais do esquema estão disponíveis no JSON Schema completo.

params.template_id
string

O ID do Template que contém suas Assembly Instructions. Se você definir allow_steps_override como false no seu Template, então steps e template_id serão mutuamente exclusivos: você pode fornecer apenas um desses parâmetros.

Parâmetros de requisição por método de autenticação

Com parâmetros assinados

Inclua sua Auth Key como params.auth.key. Ao assinar a requisição, inclua um timestamp futuro em params.auth.expires e envie a assinatura no campo separado signature. As definições de campos abaixo usam caminhos dentro de params.

Esquema JSON completo

Abrir JSON em uma nova aba

Parâmetros assinados usados para criar uma Assembly a partir de Steps diretos ou de um Template.

Usa as definições de campo acima: params.auth, params.emit_execution_progress, params.exiftool_stack, params.ffmpeg_stack, params.fields, params.imagemagick_stack, params.mediainfo_stack, params.mplayer_stack, params.nonce, params.notification_payload, params.notify_url, params.quiet, params.redirect_url, params.response_headers, params.usage_tags

Qualquer um dos esquemas a seguir pode ser aplicado:

propriedades obrigatórias: steps, template_id

Parâmetros usados para criar uma Assembly a partir de Steps diretos ou de um Template.

params: Somente os campos listados para este objeto são aceitos.

Usa as definições de campo acima: params.steps, params.template_id

Variante 2

Parâmetros usados para criar uma Assembly a partir de Steps diretos ou de um Template.

params: Somente os campos listados para este objeto são aceitos.

Usa as definições de campo acima: params.steps, params.template_id

Com um token bearer

Envie o token bearer no cabeçalho Authorization. Você pode omitir params.auth e o campo signature separado. Os demais parâmetros obrigatórios continuam se aplicando. As definições de campos abaixo usam caminhos dentro de params.

Esquema JSON completo

Abrir JSON em uma nova aba

Parâmetros usados para criar uma Assembly a partir de Steps diretos ou de um Template.

Usa as definições de campo acima: params.emit_execution_progress, params.exiftool_stack, params.ffmpeg_stack, params.fields, params.imagemagick_stack, params.mediainfo_stack, params.mplayer_stack, params.nonce, params.notification_payload, params.notify_url, params.quiet, params.redirect_url, params.response_headers, params.usage_tags

CampoTipo e descrição
params.auth
object

Metadados de autenticação e restrições de upload para uma solicitação de Assembly autenticada com Bearer. O token fornece a chave de API, portanto a solicitação pode omiti-la.

A propriedade referer é uma expressão regular a ser comparada com o referer HTTP deste upload, como "example\.org". Use-a para verificar se os valores de Referer fornecidos correspondem a um domínio esperado.

Uploads sem referer sempre passarão na verificação (pois alguns navegadores desativam o envio desse valor), o que torna essa propriedade útil em apenas alguns casos de uso. Para saber mais sobre expressões regulares, consulte a documentação de RegExp da Mozilla⁠.

Expressões regulares inválidas e expressões que excedem o limite de tempo de avaliação são rejeitadas. Essa verificação não substitui a Signature Authentication: os clientes podem omitir ou falsificar o cabeçalho Referer.

A propriedade max_size limita o tamanho total esperado do upload da Assembly em bytes, como 1048576 (1 MB), e não o de cada arquivo separadamente. Isso inclui o corpo da solicitação multipart ou os bytes da solicitação inicial da Assembly mais seus uploads retomáveis. Exceder o limite interrompe toda a Assembly com um erro, incluindo os arquivos que, individualmente, estão dentro do limite. Não dependa desse limite para rejeitar toda transferência acima do tamanho permitido antes que ela comece. Para uploads retomáveis, o tamanho declarado ou recebido fica disponível por meio de atualizações do tus, e a Assembly verifica o limite quando um upload concluído é processado. O tamanho de um upload adiado não é conhecido no momento da criação, e alguns bytes já podem ter sido transferidos antes que a Assembly o rejeite. Se você quiser apenas ignorar os arquivos que excedem um determinado tamanho, mas processar todos os outros, use 🤖/file/filter EN (English).

A propriedade max_number_of_files pode ser usada para definir um número máximo de arquivos que um upload pode conter, como 100. Especifique essa propriedade para impedir que os usuários enviem uma quantidade excessiva de arquivos, tanto por uploads de arquivos quanto por Robots de importação.

Essas propriedades podem ser definidas como parte da solicitação da Assembly ou como parte do Template.

params.auth: Somente os campos listados para este objeto são aceitos.

params.auth.expires
string

Timestamp de expiração no formato ISO 8601 situado no futuro. Obrigatório quando uma requisição é assinada ou exige autenticação por assinatura; requisições autenticadas por bearer podem omiti-lo.

params.auth.key
string

Chave de API da Transloadit usada para autenticar as requisições

params.auth.max_number_of_files
integer (mínimo: 1)

Número máximo de arquivos de entrada permitidos por Assembly. Se o número de arquivos enviados ou importados exceder esse limite, a Assembly será interrompida com um erro. Isso é útil para evitar abusos quando as credenciais de Signature Authentication ficam expostas.

params.auth.max_size
number

Tamanho total máximo esperado de upload, em bytes, para a Assembly, incluindo a sobrecarga do corpo da requisição. Esse não é um limite por arquivo e não garante a rejeição antes do início de uma transferência retomável.

params.auth.nonce
string | integer

Valor único e aleatório incluído nos parâmetros da requisição assinada para tornar cada assinatura única e evitar a reutilização acidental de assinaturas.

params.auth.referer
string

Expressão regular usada para verificar a correspondência com um HTTP Referer fornecido. Expressões inválidas e expressões que excedem o limite de tempo de avaliação são rejeitadas. Requisições sem o cabeçalho Referer são aprovadas nessa verificação; use Signature Authentication para autenticar requisições.

Qualquer um dos esquemas a seguir pode ser aplicado:

propriedades obrigatórias: steps, template_id

Parâmetros usados para criar uma Assembly a partir de Steps diretos ou de um Template.

params: Somente os campos listados para este objeto são aceitos.

Usa as definições de campo acima: params.steps, params.template_id

Variante 2

Parâmetros usados para criar uma Assembly a partir de Steps diretos ou de um Template.

params: Somente os campos listados para este objeto são aceitos.

Usa as definições de campo acima: params.steps, params.template_id

Resposta

Veja um exemplo de corpo de resposta:

{
  "account_id": "6c8b8d10d68b11e3a799b579dfce333a",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_ssl_url": "https://api2-morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_url": "http://api2.morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "bytes_expected": 1687,
  "bytes_received": 1687,
  "bytes_usage": 0,
  "companion_url": "https://api2-morven.transloadit.com/companion/",
  "execution_duration": 0.001,
  "execution_start": "2018/05/30 08:47:19 GMT",
  "fields": {},
  "instance": "morven.transloadit.com",
  "jobs_queue_duration": 0,
  "message": "The Assembly is currently being executed.",
  "ok": "ASSEMBLY_EXECUTING",
  "parent_id": null,
  "queue_duration": 0.04,
  "results": {},
  "start_date": "2018/05/30 08:47:19 GMT",
  "template": null,
  "template_id": null,
  "tus_url": "https://api2-morven.transloadit.com/resumable/files/",
  "update_stream_url": "https://api2-morven.transloadit.com/ws20243?assembly=0fce5b1063e611e88d8eb130f7921d8a",
  "upload_duration": 0.049,
  "uploads": [],
  "uppyserver_url": "https://api2-morven.transloadit.com/companion/",
  "warnings": [],
  "websocket_url": "https://api2-morven.transloadit.com/ws20243"
}

sucesso 2xx

Corpo da resposta JSON. application/json text/plain; charset=utf-8

Esquema do corpo da resposta
Esquema JSON completo

Abrir JSON em uma nova aba

CampoTipo e descrição
account_id
null | string
account_name
null | string
account_slug
null | string
api_auth_key_id
null | string
assemblyId
string
assembly_id
string

O ID único desta Assembly. Você pode armazená-lo em um banco de dados quando uma Assembly é criada e usá-lo para corresponder às Notifications recebidas.

assembly_ssl_url
null | string

A URL única usada para consultar o status atual desta Assembly, porém pronta para ser usada por SSL/HTTPS. Todas as requisições de API enviadas para a assembly_url também podem ser enviadas para a assembly_ssl_url.

assembly_url
null | string

A URL única usada para consultar o status atual desta Assembly.

build_id
string

Identificador de build opcional para a solução de problemas pelo suporte. Trate-o como opaco; ele pode mudar entre Assemblies.

bytes_expected
number

O número de bytes que esta Assembly espera que sejam enviados.

bytes_received
number

O número de bytes que foram enviados para esta Assembly até agora. Isso é usado principalmente por clientes para exibir o progresso do upload.

bytes_usage
number | null

O número total de bytes que esta Assembly processou e que contam para a sua fatura de uso. A soma de bytes_usage de todas as suas Assemblies equivale ao seu uso mensal total.

client_agent
null | string

O user agent de quem fez o upload não é exposto; este campo obsoleto é sempre null.

client_ip
null | string

O endereço IP de quem faz o upload não é exposto; este campo obsoleto é sempre null.

client_referer
null | string

A URL de referrer de quem enviou o arquivo não é exposta; este campo obsoleto é sempre null.

companion_url
null | string

A URL do servidor Companion com o qual esta Assembly pode se comunicar.

executing_jobs
Array<string>
Esquema do item do array
string
execution_duration
number | null

O tempo que a Transloadit levou para executar esta Assembly, em segundos.

execution_start
null | string
expected_tus_uploads
number
fields
object

Um mapa de chave/valor com campos de formulário adicionais para integrações que não podem usar o encapsulamento de <form>, como a Uppy.

Esquema de propriedade adicional
qualquer valor
finished_tus_uploads
number
has_dupe_jobs
boolean
ignored_error_count
number
ignored_errors
Array<object>
Esquema do item do array
object

ignored_errors[]: A resposta pode conter campos adicionais.

CampoTipo e descrição
ignored_errors[].error
qualquer valor
ignored_errors[].message
string
ignored_errors[].phase
string
ignored_errors[].step
null | string
info
object

info: A resposta pode conter campos adicionais.

info.retryIn
number
instance
null | string
is_infinite
boolean
jobs_queue_duration
number
last_job_completed
null | string
merged_params
null | string
message
string

Uma mensagem legível por humanos que explica o estado desta Assembly. Nem sempre está presente.

notify_duration
number | null

Tempo decorrido de entrega em segundos, incluindo as tentativas automáticas de reenvio e os atrasos entre elas.

notify_error
null | string
notify_response_code
number | null
notify_response_data
null | string
notify_start
null | string
notify_status
null | string
notify_url
null | string
num_input_files
number
params
null | string
parent_assembly_status
qualquer valor | null

Qualquer um dos esquemas a seguir pode ser aplicado:

qualquer valor
qualquer valor
null
null
parent_id
null | string
previousStep
string

Nome do Step anterior associado ao erro, quando disponível.

queue_duration
number
region
string
results
object

Os arquivos de resultado que a Transloadit produziu até agora. Cada chave é o nome do Step que produziu um arquivo. Os Robots de armazenamento não produzem arquivos, portanto os nomes dos seus Steps são omitidos. Quando ocorre um error, este objeto pode conter resultados parciais.

Esquema de propriedade adicional
Array<object>

Detalhes adicionais do esquema estão disponíveis no JSON Schema completo.

running_jobs
Array<string>
Esquema do item do array
string
start_date
string

A data e a hora em que o upload começou para esta Assembly.

started_jobs
Array<string>
Esquema do item do array
string
started_tus_uploads
number
step
string

Nome do Step associado ao erro, quando disponível.

template
null | string
template_id
null | string
template_name
null | string
transloadit_client
null | string
tus_uploads
Array<object>
Esquema do item do array
object

tus_uploads[]: A resposta pode conter campos adicionais.

CampoTipo e descrição
tus_uploads[].fieldname

obrigatório

string
tus_uploads[].filename

obrigatório

string
tus_uploads[].finished

obrigatório

boolean
tus_uploads[].offset

obrigatório

number
tus_uploads[].size

obrigatório

number
tus_uploads[].upload_url

obrigatório

string
tus_uploads[].user_meta
object

Detalhes adicionais do esquema estão disponíveis no JSON Schema completo.

tus_url
string

A URL do servidor tus usado por esta Assembly para uploads resumíveis.

update_stream_url
null | string

A URL de um stream de server-sent events do qual você pode obter atualizações de status em tempo real desta Assembly.

upload_duration
number

O tempo que o uploader levou para enviar os arquivos, em segundos.

upload_meta_data_extracted
boolean
uploads
Array<object>

Um array de arquivos enviados para esta Assembly. Para mais informações, consulte a documentação de metadados.

Esquema do item do array
object
CampoTipo e descrição
uploads[].as
string | Array<string> | null

Detalhes adicionais do esquema estão disponíveis no JSON Schema completo.

uploads[].asset_id
string

Identidade estável de um arquivo armazenado por /transloadit/store. Guarde esse valor junto com seu Workspace e version_id; o id comum do arquivo não é um ID de ativo de armazenamento.

uploads[].asset_version
number

Revisão numérica do ativo armazenado. Use version_id, e não este número, para selecionar os bytes exatos retidos.

uploads[].cost
number | null
uploads[].exec_time
number
uploads[].from_batch_import
boolean
uploads[].import_url
string
uploads[].is_temp_url
boolean
uploads[].is_tus_file
boolean
uploads[].md5hash
null | string
uploads[].original_basename
null | string
uploads[].original_id

obrigatório

string | Array<null | string>

O ID único do arquivo de upload original a partir do qual este arquivo foi gerado. Isso é útil para determinar qual arquivo de um upload de múltiplos arquivos foi usado para gerar um determinado arquivo, após vários Steps de processamento.

Detalhes adicionais do esquema estão disponíveis no JSON Schema completo.

uploads[].original_md5hash
null | string
uploads[].original_name
null | string
uploads[].original_path
string
uploads[].queue
null | string
uploads[].queue_time
number
uploads[].sha256
string

Checksum SHA-256 em letras minúsculas dos bytes armazenados, quando disponível.

Padrão de validação (expressão regular)^[a-f0-9]{64}$
uploads[].ssl_url
null | string
uploads[].tus_upload_url
null | string
uploads[].user_meta
object

Detalhes adicionais do esquema estão disponíveis no JSON Schema completo.

uploads[].version_id
string

ID imutável da versão retornado após a finalização do resultado pelo armazenamento. Importe com asset_id e este version_id para manter os mesmos bytes após uma movimentação ou sobrescrita, sujeito à retenção e ao acesso.

Padrão de validação (expressão regular)^[A-Za-z0-9_-]{21}[AQgw]$
uploads[].workspace
string (comprimento mínimo: 1)

Slug do Workspace ao qual este resultado armazenado pertence. Autentique-se para esse Workspace ao importar ou gerenciar esse resultado.

Qualquer um dos esquemas a seguir pode ser aplicado:

propriedades obrigatórias: basename, ext, field, id, meta, mime, name, size, type, url: object
object

uploads[]: A resposta pode conter campos adicionais.

CampoTipo e descrição
uploads[].basename

obrigatório

null | string

O nome do arquivo sem a extensão.

uploads[].ext

obrigatório

string

A extensão do arquivo.

uploads[].field

obrigatório

null | string

O nome do campo de formulário usado para enviar este arquivo.

uploads[].id

obrigatório

string

Um ID aleatório e único usado internamente pela Transloadit para rastrear o arquivo.

uploads[].meta

obrigatório

object

Um objeto contendo metadados adicionais extraídos do arquivo, conforme mostrado abaixo.

Detalhes adicionais do esquema estão disponíveis no JSON Schema completo.

uploads[].mime

obrigatório

null | string

O tipo MIME determinado para este arquivo.

uploads[].name

obrigatório

null | string

O nome do arquivo. A Transloadit alterará a extensão usada neste campo caso o arquivo passe por processamento para um formato diferente.

uploads[].size

obrigatório

number

O tamanho do arquivo, em bytes.

uploads[].type

obrigatório

null | string

Uma categoria abstrata que descreve o arquivo. Os valores conhecidos são "audio", "document", "image", "office", "pdf", "swf", "video", "xls" ou null quando nenhuma categoria foi detectada. Os consumidores devem aceitar outras strings para que categorias futuras permaneçam compatíveis.

uploads[].url

obrigatório

null | string

Uma URL da qual o arquivo pode ser baixado, ou null quando nenhuma URL de entrega estiver disponível. As URLs temporárias nos nossos servidores expiram após algumas horas; exporte os arquivos para armazenamento para uso posterior. Os resultados de armazenamento privado de /transloadit/store retornam null tanto para url quanto para ssl_url. Guarde o Workspace, o asset_id e o version_id retornados para ter uma referência duradoura, sujeita a acesso e retenção. /transloadit/import aceita asset_id com um version_id opcional, ou um path mutável. Nem uma URL temporária nem o id do arquivo em processamento são referências duradouras de armazenamento.

Variante 2: object
object

uploads[]: A resposta pode conter campos adicionais.

CampoTipo e descrição
uploads[].basename
null | string

O nome do arquivo sem a extensão.

uploads[].ext
string

A extensão do arquivo.

uploads[].field
null | string

O nome do campo de formulário usado para enviar este arquivo.

uploads[].id
nunca

Este valor é proibido.

uploads[].meta
object

Um objeto contendo metadados adicionais extraídos do arquivo, conforme mostrado abaixo.

Detalhes adicionais do esquema estão disponíveis no JSON Schema completo.

uploads[].mime
null | string

O tipo MIME determinado para este arquivo.

uploads[].name
null | string

O nome do arquivo. A Transloadit alterará a extensão usada neste campo caso o arquivo passe por processamento para um formato diferente.

uploads[].size
number

O tamanho do arquivo, em bytes.

uploads[].type
null | string

Uma categoria abstrata que descreve o arquivo. Os valores conhecidos são "audio", "document", "image", "office", "pdf", "swf", "video", "xls" ou null quando nenhuma categoria foi detectada. Os consumidores devem aceitar outras strings para que categorias futuras permaneçam compatíveis.

uploads[].url
null | string

Uma URL da qual o arquivo pode ser baixado, ou null quando nenhuma URL de entrega estiver disponível. As URLs temporárias nos nossos servidores expiram após algumas horas; exporte os arquivos para armazenamento para uso posterior. Os resultados de armazenamento privado de /transloadit/store retornam null tanto para url quanto para ssl_url. Guarde o Workspace, o asset_id e o version_id retornados para ter uma referência duradoura, sujeita a acesso e retenção. /transloadit/import aceita asset_id com um version_id opcional, ou um path mutável. Nem uma URL temporária nem o id do arquivo em processamento são referências duradouras de armazenamento.

uppyserver_url
null | string
usage_tags
string
virusname
string
warnings
Array<object>
Esquema do item do array
object

warnings[]: A resposta pode conter campos adicionais.

CampoTipo e descrição
warnings[].action
object (propriedades obrigatórias: message, text, type)

Detalhes adicionais do esquema estão disponíveis no JSON Schema completo.

warnings[].level

obrigatório

"notice" | "warning"
warnings[].msg

obrigatório

string
websocket_url
null | string

A URL de um servidor Websocket (usa Socket.IO) a partir do qual você pode obter atualizações de status em tempo real desta Assembly.

Qualquer um dos esquemas a seguir pode ser aplicado:

ok: "ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING"

A resposta pode conter campos adicionais.

CampoTipo e descrição
error
nunca

Indica um status de erro. Esta chave só está presente se a Assembly tiver falhado.

Este valor é proibido.

ok

obrigatório

"ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING"

Indica um status de ciclo de vida sem erro, incluindo os estados de upload, execução, abortado e cancelado. O processamento bem-sucedido é indicado por ASSEMBLY_COMPLETED. Se a Assembly tiver encontrado um erro, a chave error abaixo é usada em vez desta chave.

ok: "ASSEMBLY_CANCELED" | "ASSEMBLY_COMPLETED" | "ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING" | "REQUEST_ABORTED"

A resposta pode conter campos adicionais.

CampoTipo e descrição
error
nunca

Indica um status de erro. Esta chave só está presente se a Assembly tiver falhado.

Este valor é proibido.

ok

obrigatório

"ASSEMBLY_CANCELED" | "ASSEMBLY_COMPLETED" | "ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING" | "REQUEST_ABORTED"

Indica um status de ciclo de vida sem erro, incluindo os estados de upload, execução, abortado e cancelado. O processamento bem-sucedido é indicado por ASSEMBLY_COMPLETED. Se a Assembly tiver encontrado um erro, a chave error abaixo é usada em vez desta chave.

propriedades obrigatórias: error

A resposta pode conter campos adicionais.

CampoTipo e descrição
cmd
string | Array<string | number>

Detalhes opcionais do comando de processamento para resolução de problemas. Os detalhes de diagnóstico podem variar; use o código error para o tratamento programático de erros.

Qualquer um dos esquemas a seguir pode ser aplicado:

string
string
Array<string | number>
Array<string | number>
Esquema do item do array
string | number
error

obrigatório

"ADMIN_PERMISSIONS_REQUIRED" | "AI_CHAT_VALIDATION" | "ASSEMBLY_ACCOUNT_MISMATCH" | "ASSEMBLY_CANNOT_BE_REPLAYED" | "ASSEMBLY_COULD_NOT_BE_CREATED" | "ASSEMBLY_CRASHED" | "ASSEMBLY_DISALLOWED_ROBOTS_USED" | "ASSEMBLY_EMPTY_STEPS" | "ASSEMBLY_EXECUTION_PROGRESS_NOT_ENABLED" | "ASSEMBLY_EXPIRED" | "ASSEMBLY_FILE_NOT_RESERVED" | "ASSEMBLY_INFINITE" | "ASSEMBLY_INVALID_NOTIFY_URL" | "ASSEMBLY_INVALID_NUM_EXPECTED_UPLOAD_FILES_PARAM" | "ASSEMBLY_INVALID_STEPS" | "ASSEMBLY_JOB_ENQUEUE_ERROR" | "ASSEMBLY_LIST_ERROR" | "ASSEMBLY_MEMORY_LIMIT_EXCEEDED" | "ASSEMBLY_NOTIFICATIONS_LIST_ERROR" | "ASSEMBLY_NOTIFICATION_LIST_ERROR" | "ASSEMBLY_NOTIFICATION_NOT_PERSISTED" | "ASSEMBLY_NOTIFICATION_NOT_REPLAYED" | "ASSEMBLY_NOT_CAPABLE" | "ASSEMBLY_NOT_FINISHED" | "ASSEMBLY_NOT_FOUND" | "ASSEMBLY_NOT_REPLAYED" | "ASSEMBLY_NO_CHARGEABLE_STEP" | "ASSEMBLY_NO_NOTIFY_URL" | "ASSEMBLY_NO_STEPS" | "ASSEMBLY_PLAN_FILE_SIZE_LIMIT_EXCEEDED" | "ASSEMBLY_ROBOT_MISSING" | "ASSEMBLY_SATURATED" | "ASSEMBLY_STATS_ERROR" | "ASSEMBLY_STATS_INVALID_TIME" | "ASSEMBLY_STATS_MISSING_REGION" | "ASSEMBLY_STATUS_FETCHING_RATE_LIMIT_REACHED" | "ASSEMBLY_STATUS_NOT_FOUND" | "ASSEMBLY_STATUS_PARSE_ERROR" | "ASSEMBLY_STEP_INVALID" | "ASSEMBLY_STEP_INVALID_ROBOT" | "ASSEMBLY_STEP_INVALID_USE" | "ASSEMBLY_STEP_NO_ROBOT" | "ASSEMBLY_STEP_UNKNOWN_ROBOT" | "ASSEMBLY_STEP_UNKNOWN_USE" | "ASSEMBLY_URL_TRANSFORM_MISSING" | "AUDIO_ARTWORK_VALIDATION" | "AUDIO_CONCAT_INVALID_INPUT" | "AUDIO_CONCAT_VALIDATION" | "AUDIO_ENCODE_VALIDATION" | "AUDIO_LOOP_VALIDATION" | "AUDIO_MERGE_VALIDATION" | "AUDIO_SPLIT_NO_OUTPUT" | "AUDIO_SPLIT_VALIDATION" | "AUDIO_WAVEFORM_VALIDATION" | "AUTH_EXPIRED" | "AUTH_KEYS_NOT_FOUND" | "AUTH_KEY_SCOPES_NOT_FOUND" | "AUTH_SECRET_NOT_RETRIEVED" | "AZURE_IMPORT_ACCESS_DENIED" | "AZURE_IMPORT_FAILURE" | "AZURE_IMPORT_NOT_FOUND" | "AZURE_IMPORT_VALIDATION" | "AZURE_STORE_ACCESS_DENIED" | "AZURE_STORE_NOT_FOUND" | "AZURE_STORE_VALIDATION" | "BACKBLAZE_IMPORT_ACCESS_DENIED" | "BACKBLAZE_IMPORT_FAILURE" | "BACKBLAZE_IMPORT_NOT_FOUND" | "BACKBLAZE_IMPORT_VALIDATION" | "BACKBLAZE_STORE_ACCESS_DENIED" | "BACKBLAZE_STORE_FAILURE" | "BACKBLAZE_STORE_VALIDATION" | "BAD_PRICING" | "BEARER_TOKEN_AUTH_KEY_MISMATCH" | "BEARER_TOKEN_EXPIRED" | "BEARER_TOKEN_INVALID" | "BILL_LIMIT_EXCEEDED" | "BOX_IMPORT_ACCESS_DENIED" | "BOX_IMPORT_FAILURE" | "BOX_IMPORT_NOT_FOUND" | "BOX_IMPORT_VALIDATION" | "BOX_STORE_COULD_NOT_PARSE_URL" | "BOX_STORE_VALIDATION" | "CANNOT_ACCEPT_NEW_ASSEMBLIES" | "CDN_REQUIRED" | "CLOUDFILES_IMPORT_ACCESS_DENIED" | "CLOUDFILES_IMPORT_FAILURE" | "CLOUDFILES_IMPORT_NOT_FOUND" | "CLOUDFILES_IMPORT_VALIDATION" | "CLOUDFILES_STORE_ACCESS_DENIED" | "CLOUDFILES_STORE_ERROR" | "CLOUDFILES_STORE_VALIDATION" | "CLOUDFLARE_IMPORT_ACCESS_DENIED" | "CLOUDFLARE_IMPORT_FAILURE" | "CLOUDFLARE_IMPORT_NOT_FOUND" | "CLOUDFLARE_IMPORT_VALIDATION" | "CLOUDFLARE_STORE_ACCESS_DENIED" | "CLOUDFLARE_STORE_NOT_FOUND" | "CLOUDFLARE_STORE_URL_VERIFICATION_FAILURE" | "CLOUDFLARE_STORE_VALIDATION" | "CLOUDFLARE_STORE_WRONG_REGION" | "CLOUD_AI_IMAGE_VALIDATION" | "DIGITALOCEAN_IMPORT_ACCESS_DENIED" | "DIGITALOCEAN_IMPORT_FAILURE" | "DIGITALOCEAN_IMPORT_NOT_FOUND" | "DIGITALOCEAN_IMPORT_VALIDATION" | "DIGITALOCEAN_STORE_ACCESS_DENIED" | "DIGITALOCEAN_STORE_NOT_FOUND" | "DIGITALOCEAN_STORE_VALIDATION" | "DIGITALOCEAN_STORE_WRONG_REGION" | "DOCUMENT_AUTOROTATE_VALIDATION" | "DOCUMENT_CONVERT_UNSUPPORTED_CONVERSION" | "DOCUMENT_CONVERT_VALIDATION" | "DOCUMENT_EXTRACT_VALIDATION" | "DOCUMENT_MERGE_UNSUPPORTED_CONVERSION" | "DOCUMENT_MERGE_VALIDATION" | "DOCUMENT_OCR_VALIDATION" | "DOCUMENT_OPTIMIZE_UNSUPPORTED_INPUT" | "DOCUMENT_OPTIMIZE_VALIDATION" | "DOCUMENT_SPLIT_VALIDATION" | "DOCUMENT_THUMBS_INVALID_INPUT" | "DOCUMENT_THUMBS_VALIDATION" | "DO_NOT_REUSE_ASSEMBLY_IDS" | "DROPBOX_IMPORT_ACCESS_DENIED" | "DROPBOX_IMPORT_FAILURE" | "DROPBOX_IMPORT_NOT_FOUND" | "DROPBOX_IMPORT_VALIDATION" | "DROPBOX_STORE_COULD_NOT_PARSE_URL" | "DROPBOX_STORE_VALIDATION" | "FILE_COMPRESS_INVALID_INPUT" | "FILE_COMPRESS_VALIDATION" | "FILE_DECOMPRESS_INVALID_INPUT" | "FILE_DECOMPRESS_PASSWORD_INCORRECT" | "FILE_DECOMPRESS_PASSWORD_REQUIRED" | "FILE_DECOMPRESS_VALIDATION" | "FILE_DOWNLOAD_ERROR" | "FILE_FILTER_DECLINED_FILE" | "FILE_FILTER_INVALID_OPERATOR" | "FILE_FILTER_VALIDATION" | "FILE_HASH_VALIDATION" | "FILE_META_DATA_ERROR" | "FILE_PREVIEW_VALIDATION" | "FILE_READ_VALIDATION_ERROR" | "FILE_SERVE_NO_RESULT" | "FILE_SERVE_VALIDATION" | "FILE_VERIFY_INVALID_FILE" | "FILE_VERIFY_VALIDATION" | "FILE_VIRUSSCAN_DECLINED_FILE" | "FILE_VIRUSSCAN_INVALID_INPUT" | "FILE_VIRUSSCAN_VALIDATION" | "FTP_IMPORT_ACCESS_DENIED" | "FTP_IMPORT_FAILURE" | "FTP_IMPORT_NOT_FOUND" | "FTP_IMPORT_VALIDATION" | "FTP_STORE_VALIDATION" | "GET_ACCOUNT_DB_ERROR" | "GET_ACCOUNT_UNKNOWN_AUTH_KEY" | "GOOGLE_IMPORT_ACCESS_DENIED" | "GOOGLE_IMPORT_FAILURE" | "GOOGLE_IMPORT_NOT_FOUND" | "GOOGLE_IMPORT_VALIDATION" | "GOOGLE_STORE_INVALID_INPUT" | "GOOGLE_STORE_VALIDATION" | "HTML_CONVERT_VALIDATION" | "HTTP_IMPORT_ACCESS_DENIED" | "HTTP_IMPORT_FAILURE" | "HTTP_IMPORT_NOT_FOUND" | "HTTP_IMPORT_VALIDATION" | "HTTP_REQUEST_FAILURE" | "HTTP_REQUEST_VALIDATION" | "IMAGE_BGREMOVE_VALIDATION" | "IMAGE_COPYRIGHT_DETECT_DECLINED_FILE" | "IMAGE_COPYRIGHT_DETECT_VALIDATION" | "IMAGE_DESCRIBE_VALIDATION" | "IMAGE_ENHANCE_NO_INPUT_FILE" | "IMAGE_ENHANCE_VALIDATION" | "IMAGE_FACEDETECT_VALIDATION" | "IMAGE_GENERATE_VALIDATION" | "IMAGE_MERGE_FAILURE" | "IMAGE_MERGE_VALIDATION" | "IMAGE_OCR_VALIDATION" | "IMAGE_OPTIMIZE_VALIDATION" | "IMAGE_RESIZE_ERROR" | "IMAGE_RESIZE_INVALID_BLUR_REGION" | "IMAGE_RESIZE_INVALID_TEXT_OBJECT_VALUE" | "IMAGE_RESIZE_INVALID_TEXT_VALUE" | "IMAGE_RESIZE_INVALID_WATERMARK_OFFSET" | "IMAGE_RESIZE_INVALID_WATERMARK_POSITION" | "IMAGE_RESIZE_NO_CLUT_FILE" | "IMAGE_RESIZE_NO_INPUT_FILE" | "IMAGE_RESIZE_VALIDATION" | "IMAGE_UPSCALE_VALIDATION" | "IMPORT_FILE_ERROR" | "INCOMPLETE_PRICING" | "INSUFFICIENT_AUTH_SCOPE" | "INTERNAL_COMMAND_ERROR" | "INTERNAL_COMMAND_TIMEOUT" | "INVALID_ASSEMBLY_STATUS" | "INVALID_AUTH_EXPIRES_PARAMETER" | "INVALID_AUTH_KEY_PARAMETER" | "INVALID_AUTH_MAX_NUMBER_OF_FILES_PARAMETER" | "INVALID_AUTH_MAX_SIZE_PARAMETER" | "INVALID_AUTH_REFERER_PARAMETER" | "INVALID_FILE_META_DATA" | "INVALID_FORM_DATA" | "INVALID_INPUT_ERROR" | "INVALID_PARAMS_FIELD" | "INVALID_SIGNATURE" | "INVALID_STEP_NAME" | "INVALID_TEMPLATE_FIELD" | "INVALID_UPLOAD_HANDLE_STEP_NAME" | "INVALID_URL_ENCODING" | "MAX_NUMBER_OF_FILES_EXCEEDED" | "MAX_SIZE_EXCEEDED" | "MEGA_IMPORT_ACCESS_DENIED" | "MEGA_IMPORT_FAILURE" | "MEGA_IMPORT_NOT_FOUND" | "MEGA_IMPORT_VALIDATION" | "MEGA_STORE_ACCESS_DENIED" | "MEGA_STORE_NOT_FOUND" | "MEGA_STORE_VALIDATION" | "MEGA_STORE_WRONG_REGION" | "META_WRITE_VALIDATION" | "MINIO_IMPORT_ACCESS_DENIED" | "MINIO_IMPORT_FAILURE" | "MINIO_IMPORT_NOT_FOUND" | "MINIO_IMPORT_VALIDATION" | "MINIO_STORE_ACCESS_DENIED" | "MINIO_STORE_NOT_FOUND" | "MINIO_STORE_VALIDATION" | "MINIO_STORE_WRONG_REGION" | "NO_AUTH_EXPIRES_PARAMETER" | "NO_AUTH_KEY_PARAMETER" | "NO_AUTH_PARAMETER" | "NO_COUNTRY" | "NO_OBJECT_AUTH_PARAMETER" | "NO_OBJECT_PARAMS_FIELD" | "NO_PARAMS_FIELD" | "NO_PRICING" | "NO_RESULT_STEP_FOUND" | "NO_RPC_RESULT_FROM_IMAGE_RESIZER" | "NO_SIGNATURE_FIELD" | "NO_TEMPLATE_ID" | "PLAN_LIMIT_EXCEEDED" | "POSSIBLY_MALICIOUS_FILE_FOUND" | "PRIORITY_JOB_SLOTS_NOT_FOUND" | "PRIORITY_JOB_SLOT_STATS_ERROR" | "PRIORITY_JOB_SLOT_STATS_INVALID_AGGREGATION" | "PRIORITY_JOB_SLOT_STATS_INVALID_TIME" | "PRIORITY_JOB_SLOT_STATS_MISSING_REGION" | "RATE_LIMIT_REACHED" | "REFERER_MISMATCH" | "REQUEST_PREMATURE_CLOSED" | "ROBOT_VALIDATION_BASE_ERROR" | "S3_ACCESS_DENIED" | "S3_IMPORT_ACCESS_DENIED" | "S3_IMPORT_FAILURE" | "S3_IMPORT_NOT_FOUND" | "S3_IMPORT_VALIDATION" | "S3_NOT_FOUND" | "S3_STORE_ACCESS_DENIED" | "S3_STORE_FAILURE" | "S3_STORE_NOT_FOUND" | "S3_STORE_URL_VERIFICATION_FAILURE" | "S3_STORE_VALIDATION" | "S3_STORE_WRONG_REGION" | "S3_WRONG_REGION" | "SCRIPT_RUN_VALIDATION" | "SERVER_403" | "SERVER_404" | "SERVER_500" | "SFTP_IMPORT_ACCESS_DENIED" | "SFTP_IMPORT_FAILURE" | "SFTP_IMPORT_NOT_FOUND" | "SFTP_IMPORT_VALIDATION" | "SFTP_STORE_VALIDATION" | "SIGNATURE_REUSE_DETECTED" | "SPEECH_TRANSCRIBE_VALIDATION" | "STORAGE_GRANT_NOT_CREATED" | "SUPABASE_IMPORT_ACCESS_DENIED" | "SUPABASE_IMPORT_FAILURE" | "SUPABASE_IMPORT_NOT_FOUND" | "SUPABASE_IMPORT_VALIDATION" | "SUPABASE_STORE_ACCESS_DENIED" | "SUPABASE_STORE_NOT_FOUND" | "SUPABASE_STORE_VALIDATION" | "SUPABASE_STORE_WRONG_REGION" | "SWIFT_IMPORT_ACCESS_DENIED" | "SWIFT_IMPORT_FAILURE" | "SWIFT_IMPORT_NOT_FOUND" | "SWIFT_IMPORT_VALIDATION" | "SWIFT_STORE_ACCESS_DENIED" | "SWIFT_STORE_NOT_FOUND" | "SWIFT_STORE_VALIDATION" | "SWIFT_STORE_WRONG_REGION" | "TEMPLATE_CREDENTIALS_INJECTION_ERROR" | "TEMPLATE_DB_ERROR" | "TEMPLATE_DENIES_STEPS_OVERRIDE" | "TEMPLATE_INVALID_JSON" | "TEMPLATE_NOT_FOUND" | "TEXT_SPEAK_VALIDATION" | "TEXT_TRANSLATE_VALIDATION" | "TIGRIS_IMPORT_ACCESS_DENIED" | "TIGRIS_IMPORT_FAILURE" | "TIGRIS_IMPORT_NOT_FOUND" | "TIGRIS_IMPORT_VALIDATION" | "TIGRIS_STORE_ACCESS_DENIED" | "TIGRIS_STORE_NOT_FOUND" | "TIGRIS_STORE_VALIDATION" | "TIGRIS_STORE_WRONG_REGION" | "TMP_FILE_DOWNLOAD_ERROR" | "TOKEN_INVALID_CREDENTIALS" | "TRANSIENT_STORAGE_SERVICE_ERROR" | "TRANSLOADIT_IMPORT_ACCESS_DENIED" | "TRANSLOADIT_IMPORT_FAILURE" | "TRANSLOADIT_IMPORT_NOT_FOUND" | "TRANSLOADIT_IMPORT_VALIDATION" | "TRANSLOADIT_STORE_CONFLICT" | "TRANSLOADIT_STORE_FAILURE" | "TRANSLOADIT_STORE_UNAVAILABLE" | "TRANSLOADIT_STORE_VALIDATION" | "TUS_STORE_VALIDATION" | "USER_COMMAND_ERROR" | "VERIFIED_EMAIL_REQUIRED" | "VIDEO_ADAPTIVE_VALIDATION" | "VIDEO_ARTWORK_VALIDATION" | "VIDEO_CONCAT_INVALID_INPUT" | "VIDEO_CONCAT_NO_OUTPUT" | "VIDEO_CONCAT_VALIDATION" | "VIDEO_ENCODE_INVALID_VIDEO_CODEC" | "VIDEO_ENCODE_INVALID_WATERMARK_POSITION" | "VIDEO_ENCODE_VALIDATION" | "VIDEO_GENERATE_VALIDATION" | "VIDEO_MERGE_NO_IMAGE_FOUND" | "VIDEO_MERGE_VALIDATION" | "VIDEO_ONDEMAND_NOT_FOUND" | "VIDEO_ONDEMAND_VALIDATION" | "VIDEO_SPLIT_NO_OUTPUT" | "VIDEO_SPLIT_VALIDATION" | "VIDEO_SUBTITLE_VALIDATION" | "VIDEO_THUMBS_INVALID_COUNT_VALUE" | "VIDEO_THUMBS_INVALID_FORMAT" | "VIDEO_THUMBS_INVALID_INPUT" | "VIDEO_THUMBS_VALIDATION" | "VIMEO_IMPORT_ACCESS_DENIED" | "VIMEO_IMPORT_FAILURE" | "VIMEO_IMPORT_NOT_FOUND" | "VIMEO_IMPORT_VALIDATION" | "VIMEO_STORE_ACCESS_DENIED" | "VIMEO_STORE_PROBLEM_SENDING_FILE" | "VIMEO_STORE_VALIDATION" | "WASABI_IMPORT_ACCESS_DENIED" | "WASABI_IMPORT_FAILURE" | "WASABI_IMPORT_NOT_FOUND" | "WASABI_IMPORT_VALIDATION" | "WASABI_STORE_ACCESS_DENIED" | "WASABI_STORE_NOT_FOUND" | "WASABI_STORE_VALIDATION" | "WASABI_STORE_WRONG_REGION" | "WORKER_JOB_ERROR" | "YOUTUBE_STORE_PROBLEM_SENDING_FILE" | "YOUTUBE_STORE_VALIDATION"

Indica um status de erro. Esta chave só está presente se a Assembly tiver falhado.

exitCode
number | null

Status de saída opcional de um comando de processamento que falhou. Os detalhes de diagnóstico podem variar; use o código error para o tratamento programático de erros.

exitSignal
null | string

Sinal opcional que encerrou um comando de processamento. Os detalhes de diagnóstico podem variar; use o código error para o tratamento programático de erros.

file
string
headers
object
Esquema de propriedade adicional
qualquer valor
is_private_address
boolean
name
string
numRetries
number
ok
null
playwright_error_code
string
reason
string

Explicação opcional da falha. Os detalhes de diagnóstico podem variar; use o código error para o tratamento programático de erros.

response_code
number | null
retries
number
retryable
boolean
stderr
string

Saída de diagnóstico opcional de um comando de processamento, para solução de problemas. Os detalhes do diagnóstico podem variar; use o código error para o tratamento programático de erros.

stdout
string

Saída padrão opcional de um comando de processamento, para solução de problemas. Os detalhes de diagnóstico podem variar; use o código error para o tratamento programático de erros.

url
string
url_host
null | string

Resposta de erro

Corpo da resposta JSON. application/json text/plain; charset=utf-8

Esquema do corpo da resposta
Esquema JSON completo

Abrir JSON em uma nova aba

Pelo menos uma destas propriedades é obrigatória: error, message, reason

A resposta pode conter campos adicionais.

CampoTipo e descrição
assembly_id
string
error
string (comprimento mínimo: 1)
http_code
number | string
  • number
  • string
    Padrão de validação (expressão regular)^[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]*[+-]?0*(?:0(?:[^0-9]|$)|(?:[1-9][0-9]{0,307}|1(?:(?:[0-6][0-9]{7}|7[0-8][0-9]{6}|79[0-6][0-9]{5}|797[0-5][0-9]{4}|7976[0-8][0-9]{3}|79769[0-2][0-9]{2}|7976930[0-9]{1}|7976931[0-2])[0-9]{300}|79769313(?:(?:[0-3][0-9]{7}|4[0-7][0-9]{6}|48[0-5][0-9]{5}|486[0-1][0-9]{4}|4862[0-2][0-9]{3}|486230[0-9]{2}|486231[0-4][0-9]{1}|4862315[0-7])[0-9]{292}|48623158(?:(?:0[0-6][0-9]{6}|07[0-8][0-9]{5}|079[0-2][0-9]{4}|0793[0-6][0-9]{3}|07937[0-1][0-9]{2}|079372[0-7][0-9]{1}|0793728[0-8])[0-9]{284}|07937289(?:(?:[0-6][0-9]{7}|70[0-9]{6}|71[0-3][0-9]{5}|7140[0-4][0-9]{3}|71405[0-2][0-9]{2}|7140530[0-2])[0-9]{276}|71405303(?:(?:[0-3][0-9]{7}|40[0-9]{6}|41[0-4][0-9]{5}|4150[0-6][0-9]{3}|41507[0-8][0-9]{2}|415079[0-8][0-9]{1}|4150799[0-2])[0-9]{268}|41507993(?:(?:[0-3][0-9]{7}|40[0-9]{6}|41[0-2][0-9]{5}|413[0-1][0-9]{4}|4132[0-6][0-9]{3}|413270[0-9]{2})[0-9]{260}|41327100(?:(?:[0-2][0-9]{7}|3[0-6][0-9]{6}|37[0-7][0-9]{5}|378[0-1][0-9]{4}|3782[0-5][0-9]{3}|37826[0-8][0-9]{2}|378269[0-2][0-9]{1}|3782693[0-5])[0-9]{252}|37826936(?:(?:0[0-9]{7}|1[0-6][0-9]{6}|17[0-2][0-9]{5}|173[0-6][0-9]{4}|1737[0-6][0-9]{3}|17377[0-7][0-9]{2}|173778[0-8][0-9]{1}|1737789[0-7])[0-9]{244}|17377898(?:(?:0[0-3][0-9]{6}|04[0-3][0-9]{5}|044[0-3][0-9]{4}|0444[0-8][0-9]{3}|04449[0-5][0-9]{2}|044496[0-7][0-9]{1}|0444968[0-1])[0-9]{236}|04449682(?:(?:[0-8][0-9]{7}|9[0-1][0-9]{6}|92[0-6][0-9]{5}|927[0-5][0-9]{4}|9276[0-3][0-9]{3}|92764[0-6][0-9]{2}|927647[0-4][0-9]{1})[0-9]{228}|92764750(?:(?:[0-8][0-9]{7}|9[0-3][0-9]{6}|94[0-5][0-9]{5}|946[0-5][0-9]{4}|9466[0-3][0-9]{3}|94664[0-8][0-9]{2}|94664900)[0-9]{220}|94664901(?:(?:[0-6][0-9]{7}|7[0-8][0-9]{6}|79[0-6][0-9]{5}|797[0-6][0-9]{4}|7977[0-4][0-9]{3}|79775[0-7][0-9]{2}|797758[0-6][0-9]{1}|7977587[0-1])[0-9]{212}|79775872(?:(?:0[0-6][0-9]{6}|070[0-8][0-9]{4}|0709[0-5][0-9]{3}|07096[0-2][0-9]{2}|070963[0-2][0-9]{1})[0-9]{204}|07096330(?:(?:[0-1][0-9]{7}|2[0-7][0-9]{6}|28[0-5][0-9]{5}|286[0-3][0-9]{4}|28640[0-9]{3}|28641[0-5][0-9]{2}|286416[0-5][0-9]{1}|2864166[0-8])[0-9]{196}|28641669(?:(?:[0-1][0-9]{7}|2[0-7][0-9]{6}|28[0-7][0-9]{5}|288[0-6][0-9]{4}|2887[0-8][0-9]{3}|288790[0-9]{2}|2887910[0-8])[0-9]{188}|28879109(?:(?:[0-3][0-9]{7}|4[0-5][0-9]{6}|46[0-4][0-9]{5}|465[0-4][0-9]{4}|4655[0-4][0-9]{3}|46555[0-4][0-9]{2}|465555[0-3][0-9]{1}|4655554[0-6])[0-9]{180}|46555547(?:(?:[0-7][0-9]{7}|8[0-4][0-9]{6}|850[0-9]{5}|851[0-8][0-9]{4}|8519[0-3][0-9]{3}|851940[0-3][0-9]{1})[0-9]{172}|85194040(?:(?:[0-1][0-9]{7}|2[0-5][0-9]{6}|26[0-2][0-9]{5}|2630[0-5][0-9]{3}|26306[0-4][0-9]{2}|263065[0-6][0-9]{1}|2630657[0-3])[0-9]{164}|26306574(?:(?:[0-7][0-9]{7}|8[0-7][0-9]{6}|88[0-5][0-9]{5}|886[0-6][0-9]{4}|88670[0-9]{3}|88671[0-4][0-9]{2}|8867150[0-4])[0-9]{156}|88671505(?:(?:[0-7][0-9]{7}|8[0-1][0-9]{6}|820[0-5][0-9]{4}|8206[0-7][0-9]{3}|820680[0-9]{2}|820681[0-8][0-9]{1})[0-9]{148}|82068190(?:(?:[0-7][0-9]{7}|8[0-8][0-9]{6}|890[0-1][0-9]{4}|8902000[0-6])[0-9]{140}|89020007(?:(?:0[0-7][0-9]{6}|08[0-2][0-9]{5}|083[0-7][0-9]{4}|0838[0-2][0-9]{3}|08383[0-5][0-9]{2}|083836[0-6][0-9]{1}|0838367[0-5])[0-9]{132}|08383676(?:(?:[0-1][0-9]{7}|2[0-6][0-9]{6}|27[0-2][0-9]{5}|273[0-7][0-9]{4}|2738[0-4][0-9]{3}|27385[0-3][0-9]{2}|273854[0-7][0-9]{1}|2738548[0-3])[0-9]{124}|27385484(?:(?:[0-4][0-9]{7}|5[0-7][0-9]{6}|580[0-9]{5}|581[0-6][0-9]{4}|5817[0-6][0-9]{3}|581770[0-9]{2}|5817710[0-9]{1}|5817711[0-4])[0-9]{116}|58177115(?:(?:[0-2][0-9]{7}|30[0-9]{6}|31[0-6][0-9]{5}|317[0-5][0-9]{4}|3176[0-3][0-9]{3}|31764[0-3][0-9]{2}|317644[0-6][0-9]{1}|3176447[0-4])[0-9]{108}|31764475(?:(?:[0-6][0-9]{7}|7[0-2][0-9]{6}|730[0-1][0-9]{4}|7302[0-6][0-9]{3}|7302700[0-5])[0-9]{100}|73027006(?:(?:[0-8][0-9]{7}|9[0-7][0-9]{6}|98[0-4][0-9]{5}|985[0-4][0-9]{4}|9855[0-4][0-9]{3}|98555[0-6][0-9]{2}|9855570[0-9]{1}|9855571[0-2])[0-9]{92}|98555713(?:(?:[0-5][0-9]{7}|6[0-5][0-9]{6}|66[0-8][0-9]{5}|669[0-4][0-9]{4}|6695[0-8][0-9]{3}|66959[0-5][0-9]{2}|669596[0-1][0-9]{1}|6695962[0-1])[0-9]{84}|66959622(?:(?:[0-7][0-9]{7}|8[0-3][0-9]{6}|84[0-1][0-9]{5}|842[0-8][0-9]{4}|84290[0-9]{3}|84291[0-3][0-9]{2}|842914[0-7][0-9]{1}|84291480)[0-9]{76}|84291481(?:(?:[0-8][0-9]{7}|9[0-7][0-9]{6}|98[0-5][0-9]{5}|9860[0-7][0-9]{3}|98608[0-2][0-9]{2}|986083[0-3][0-9]{1}|9860834[0-8])[0-9]{68}|98608349(?:(?:[0-2][0-9]{7}|3[0-5][0-9]{6}|36[0-3][0-9]{5}|364[0-6][0-9]{4}|3647[0-4][0-9]{3}|36475[0-1][0-9]{2}|364752[0-8][0-9]{1}|3647529[0-1])[0-9]{60}|36475292(?:(?:[0-6][0-9]{7}|70[0-9]{6}|71[0-8][0-9]{5}|7190[0-6][0-9]{3}|71907[0-3][0-9]{2}|7190740[0-9]{1}|7190741[0-5])[0-9]{52}|71907416(?:(?:[0-7][0-9]{7}|8[0-3][0-9]{6}|84[0-3][0-9]{5}|844[0-3][0-9]{4}|8444[0-2][0-9]{3}|84443[0-5][0-9]{2}|844436[0-4][0-9]{1}|8444365[0-4])[0-9]{44}|84443655(?:(?:0[0-9]{7}|10[0-6][0-9]{5}|1070[0-3][0-9]{3}|10704[0-2][0-9]{2}|107043[0-3][0-9]{1}|1070434[0-1])[0-9]{36}|10704342(?:(?:[0-6][0-9]{7}|70[0-9]{6}|710[0-9]{5}|711[0-4][0-9]{4}|7115[0-4][0-9]{3}|71155[0-8][0-9]{2}|711559[0-5][0-9]{1}|7115596[0-8])[0-9]{28}|71155969(?:(?:[0-8][0-9]{7}|9[0-4][0-9]{6}|950[0-7][0-9]{4}|95080[0-8][0-9]{2}|950809[0-2][0-9]{1})[0-9]{20}|95080930(?:(?:[0-3][0-9]{7}|4[0-1][0-9]{6}|42[0-7][0-9]{5}|428[0-7][0-9]{4}|428800[0-9]{2}|428801[0-6][0-9]{1}|4288017[0-6])[0-9]{12}|42880177(?:(?:[0-8][0-9]{7}|90[0-3][0-9]{5}|9040[0-9]{4}|9041[0-6][0-9]{3}|90417[0-3][0-9]{2}|904174[0-3][0-9]{1}|9041744[0-8])[0-9]{4}|90417449(?:(?:[0-6][0-9]{3}|7[0-6][0-9]{2}|77[0-8][0-9]{1}|7790)|7791))))))))))))))))))))))))))))))))))))))))(?:[^0-9]|$))
message
string

Explicação do erro legível por humanos. A redação pode variar; use o código error ao tratar uma falha específica.

reason
null | string | number | boolean | Array<qualquer valor> | object

Qualquer um dos esquemas a seguir pode ser aplicado:

null
null
string
string
number
number
boolean
boolean
Array<qualquer valor>
Array<qualquer valor>
Esquema do item do array
qualquer valor
object
object
Esquema de propriedade adicional
qualquer valor

HTTP 400

Corpo da resposta JSON. application/json text/plain; charset=utf-8

Esquema do corpo da resposta
Esquema JSON completo

Abrir JSON em uma nova aba

Erros nomeados e o formato geral de erro

error: "INVALID_PARAMS_FIELD"

Campo params inválido fornecido, ele contém json inválido.

A resposta pode conter campos adicionais.

CampoTipo e descrição
error

obrigatório

string (sempre: "INVALID_PARAMS_FIELD")
http_code
number (sempre: 400)
message
string

Explicação do erro legível por humanos. A redação pode variar; use o código error ao tratar uma falha específica.

Formato geral de erro

Consulte os campos gerais de resposta de erro.

Para mais informações sobre a resposta, consulte nossa documentação da resposta do Assembly Status.

Página anterior ← Obter um Assembly StatusPróxima página Transmitir alterações da Assembly em tempo real →
Falar com o suporte⁠

TransloaditVerificando status…

Produto

  • Serviços
  • Preços
  • Demonstrações EN (English)
  • Ferramentas EN (English)
  • Segurança EN (English)
  • Suporte

Empresa

  • Sobre EN (English)/Imprensa EN (English)
  • Blog EN (English)/Vagas EN (English)
  • Comparações EN (English)/Matriz de conformidade EN (English)
  • Pesquisa EN (English)
  • Código aberto EN (English)
  • Soluções EN (English)

Documentação

  • Primeiros passos
  • Transcodificação EN (English)
  • Perguntas frequentes EN (English)
  • API
  • Guias EN (English)/Dicas para devs EN (English)
  • Formatos suportados EN (English)

Mais

  • Status da plataforma⁠
  • Fórum da comunidade⁠
  • StackOverflow⁠
  • Uppy EN (English)
  • tus⁠

© 2009–2026 Transloadit-II GmbH

Privacidade EN (English)Termos EN (English)Aviso legal EN (English)
EnglishDeutschEspañolPortuguês (Brasil)