Upload de arquivo por meio de webhooks de documentos
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
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
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"
}