Опубликовать файл по публичной ссылке
Создаёт публичную ссылку для скачивания, которая открывает файл без входа, для изображения или документа, на который ссылается письмо или веб-страница.
Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.
POST /files/{id}/links
Создаёт публичную ссылку для скачивания, которая открывает файл без входа, для изображения или документа, на который ссылается письмо или веб-страница.
Пример
Нужен files:write. Тело необязательно. domain называет домен, чей файловый хост отдаёт ссылку, например acme.com для files.acme.com. Ответ это 201 с новой ссылкой.
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"}Ссылка отдаётся с файлового хоста domain, если у этого домена он есть. Без него или если у домена его нет, она отдаётся с файлового хоста адреса, которому принадлежит файл, а если нет и его, то с адреса API.
Файл, пришедший или ушедший с письмом, сначала копируется в публичное хранилище. Программа или скрипт отклоняются с 422 file_unshareable.
Каждый вызов создаёт новую ссылку со своим счётчиком скачиваний, поэтому повтор после потерянного ответа создаёт вторую. Перед новой попыткой получите список ссылок через GET /files/{id}/links.
Ссылка работает, пока её не отзовут или пока файл не удалят.