⌘ KIntegre sua automação ao seu sistema
Envie um arquivo ou lote para um fluxo criado no painel e receba os arquivos processados diretamente no seu sistema.
Nesta página
1. Crie e publique sua automação
Monte o fluxo exclusivamente no painel de Automações. Use Envio manual, escolha as etapas de Redimensionar, Comprimir ou Converter e publique a versão que sua integração deve executar.
- Para receber vários arquivos na mesma execução, selecione Arquivo único ou lote no gatilho.
- Abra Integrar e copie o ID e a versão publicada. O código não cria nem altera a automação.
2. Crie a integração e autorize a automação
No painel API, escolha Criar chave. Selecione Executar e Consultar e marque a automação publicada que essa integração poderá usar. Guarde a chave no ambiente do servidor da sua aplicação.
A chave completa aparece uma única vez. A autorização das automações é definida nessa criação; para mudar o acesso, crie outra chave e desative a anterior.
3. Separe os dados da integração
| Dado | Onde encontrar |
|---|---|
| URL da API | https://duckfile.com/api/v1/external |
| Chave da integração | API → Criar chave. Guarde somente no servidor. |
| ID da automação | Automações → abrir o fluxo → Integrar. |
| Versão publicada | Na mesma tela Integrar. Atualize no código após revisar uma nova publicação. |
Todas as chamadas usam HTTPS com certificado válido. O webhook, quando utilizado, também exige HTTPS.
4. Envie e receba com uma chamada
Escolha a linguagem, baixe o arquivo de integração e incorpore ao seu projeto. A função recebe um caminho ou uma lista de caminhos e cuida do envio, acompanhamento e recebimento de cada resultado.
Os exemplos têm código-fonte disponível e não são um SDK oficial. Os arquivos recebidos ficam no seu servidor, para seu sistema continuar o processo.
Arquivos no seu sistema
Os envios da API não são salvos na biblioteca da conta nem ocupam a cota do seu armazenamento. Mesmo que a automação tenha um destino de armazenamento para uso no painel, a execução pela API entrega os resultados à integração.
Originais e resultados passam apenas pela área temporária privada de processamento e entrega. Os resultados ficam disponíveis por até 15 minutos após concluir; depois expiram e entram na limpeza automática. Seu sistema deve guardar os arquivos recebidos.
Registros técnicos, de uso e de créditos continuam necessários para acompanhar as execuções. Eles não são uma biblioteca de arquivos.