API
공개 링크로 파일 게시
로그인 없이 파일을 여는 공개 다운로드 링크를 만듭니다. 이메일이나 웹 페이지에서 참조하는 이미지나 문서에 씁니다.
POSTapi.openemail.uk/files/{id}/links
본인 키로 워크스페이스에 실제 호출을 실행합니다.
POST /files/{id}/links
로그인 없이 파일을 여는 공개 다운로드 링크를 만듭니다. 이메일이나 웹 페이지에서 참조하는 이미지나 문서에 씁니다.
예시
files:write가 필요합니다. 본문은 선택 사항입니다. domain은 링크를 제공할 파일 호스트의 도메인을 지정하며, 예를 들어 files.acme.com이면 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로 링크를 나열하세요.
링크는 취소되거나 파일이 삭제될 때까지 계속 작동합니다.