Publicar um ficheiro numa ligação pública
Cria uma ligação de transferência pública que abre o ficheiro sem início de sessão, para uma imagem ou um documento referenciado num email ou numa página web.
Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.
POST /files/{id}/links
Cria uma ligação de transferência pública que abre o ficheiro sem início de sessão, para uma imagem ou um documento referenciado num email ou numa página web.
Exemplo
Precisa de files:write. O corpo é opcional. domain indica o domínio cujo anfitrião de ficheiros serve a ligação, como acme.com para files.acme.com. A resposta é um 201 com a nova ligação.
curl -X POST "$OE/files/file_6bb640f5b99e47deb758f1f5/links" -H "$AUTH" -H 'content-type: application/json' -d '{ "domain": "acme.com" }'{ "object": "file_link", "id": "fshr_4d7a0c2e9b16f3584a2c7e90", "fileId": "file_6bb640f5b99e47deb758f1f5", "filename": "invoice-0912.pdf", "mimeType": "application/pdf", "sizeBytes": 184233, "host": "files.acme.com", "url": "https://files.acme.com/f/8c2e…/invoice-0912.pdf", "downloads": 0, "lastDownloadAt": null, "revokedAt": null, "createdAt": "2026-09-24T10:02:17.000Z"}A ligação é servida no anfitrião de ficheiros de domain quando esse domínio tem um. Sem ele, ou quando esse domínio não tem nenhum, é servida no anfitrião de ficheiros do endereço a que o ficheiro pertence e, na falta deste, no endereço da API.
Um ficheiro que entrou ou saiu numa mensagem é primeiro copiado para o armazenamento público. Um programa ou um script é recusado com um 422 file_unshareable.
Cada chamada cria uma nova ligação com a sua própria contagem de transferências, por isso repetir depois de uma resposta perdida cria uma segunda. Liste as ligações com GET /files/{id}/links antes de tentar de novo.
Uma ligação continua a funcionar até ser revogada ou o ficheiro ser eliminado.