DocumentaçãoWorkfrontGuia do Workfront

Upload de arquivo por meio de webhooks de documentos

Última atualização: 26 de abril de 2025
  • Tópicos:

Criado para:

  • Desenvolvedor

O upload de um arquivo para um provedor de armazenamento de documentos é um processo de duas etapas que requer dois endpoints de API separados. O Adobe Workfront inicia o processo de upload chamando /uploadInit. Esse ponto de extremidade retorna uma ID de documento que é passada para /upload ao carregar os bytes do documento. Dependendo do sistema de armazenamento de documentos subjacente, pode ser necessário criar um documento de comprimento zero e, em seguida, atualizar o conteúdo do documento posteriormente.

Adicionado à versão 1.1 desta especificação, o ID do documento e o ID da versão do documento podem ser usados para recuperar informações adicionais do Workfront.

Exemplo: se o sistema de gerenciamento de documentos desejar obter informações adicionais sobre o documento, o código de implementação do webhook poderá usar a ID do documento para recuperar essas informações usando a API RESTful do Workfront. Como prática recomendada, essas informações podem vir de campos de dados personalizados no documento e estão contendo tarefas, problemas ou projetos.

Método POST

URL

POST /uploadInit

Parâmetros de consulta

Nome
Descrição
parentId
A ID da pasta pai, conforme referenciado pelo provedor do webhook.
filename
O nome do documento
documentId
A ID do documento do Workfront (adicionada na versão 1.1)
documentVersionId
A ID da versão do documento do Workfront (adicionada na versão 1.1)

Resposta

Os metadados do arquivo, conforme definido pelo endpoint /metadata. Isso inclui a ID do documento usada pelo provedor.

Exemplo:

https://www.acme.com/api/uploadInit?parentId=12345&filename=new-file.png&documentId=511ea6e000023edb38d2effb2f4e6e3b&documentVersionId=511ea6e000023edb38d2e ffb2f4e6e3b

Método PUT

Carrega os bytes de um documento para o provedor de webhook.

URL

PUT /upload

Parâmetros de consulta

Nome
Descrição
id
A ID do documento que acabou de ser criada.

Solicitar corpo

Os bytes de conteúdo bruto do documento.

Resposta

{
result: "success"
}

ou

{
result: "fail"
}

Exemplo

https://www.acme.com/api/upload?id=1234 [document bytes included in update stream]

resposta

{
result:"success"
}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43