Eine Datei unter einem öffentlichen Link veröffentlichen
Erzeugt einen öffentlichen Download-Link, der die Datei ohne Anmeldung öffnet, für ein Bild oder ein Dokument, auf das eine E-Mail oder eine Webseite verweist.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /files/{id}/links
Erzeugt einen öffentlichen Download-Link, der die Datei ohne Anmeldung öffnet, für ein Bild oder ein Dokument, auf das eine E-Mail oder eine Webseite verweist.
Beispiel
Benötigt files:write. Der Body ist optional. domain nennt die Domain, deren Datei-Host den Link ausliefert, etwa acme.com für files.acme.com. Die Antwort ist ein 201 mit dem neuen Link.
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"}Der Link wird auf dem Datei-Host von domain ausgeliefert, wenn diese Domain einen hat. Ohne sie, oder wenn diese Domain keinen hat, wird er auf dem Datei-Host der Adresse ausgeliefert, zu der die Datei gehört, und andernfalls auf der API-Adresse.
Eine Datei, die mit einer Nachricht ein- oder ausging, wird zuerst in öffentlichen Speicher kopiert. Ein Programm oder ein Skript wird mit einem 422 file_unshareable abgelehnt.
Jeder Aufruf erzeugt einen neuen Link mit eigenem Download-Zähler, ein erneuter Versuch nach einer verlorenen Antwort erzeugt also einen zweiten. Listen Sie die Links mit GET /files/{id}/links auf, bevor Sie es erneut versuchen.
Ein Link funktioniert, bis er widerrufen oder die Datei gelöscht wird.