Publier un fichier via un lien public
Crée un lien de téléchargement public qui ouvre le fichier sans connexion, pour une image ou un document référencé depuis un e-mail ou une page web.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
POST /files/{id}/links
Crée un lien de téléchargement public qui ouvre le fichier sans connexion, pour une image ou un document référencé depuis un e-mail ou une page web.
Exemple
Nécessite files:write. Le corps est facultatif. domain désigne le domaine dont l'hôte de fichiers sert le lien, par exemple acme.com pour files.acme.com. La réponse est un 201 avec le nouveau lien.
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"}Le lien est servi sur l'hôte de fichiers de domain si ce domaine en a un. Sans lui, ou si ce domaine n'en a pas, il est servi sur l'hôte de fichiers de l'adresse à laquelle appartient le fichier, et à défaut sur l'adresse de l'API.
Un fichier arrivé ou parti avec un message est d'abord copié vers le stockage public. Un programme ou un script est refusé avec un 422 file_unshareable.
Chaque appel crée un nouveau lien avec son propre compteur de téléchargements : une nouvelle tentative après une réponse perdue en crée donc un second. Listez les liens avec GET /files/{id}/links avant de réessayer.
Un lien fonctionne jusqu'à ce qu'il soit révoqué ou que le fichier soit supprimé.