API

ファイルを公開リンクで公開する

ログインなしでファイルを開ける公開ダウンロードリンクを作る。メールや Web ページから参照する画像や文書のためのもの。

POSTapi.openemail.uk/files/{id}/links

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

POST /files/{id}/links

ログインなしでファイルを開ける公開ダウンロードリンクを作る。メールや Web ページから参照する画像や文書のためのもの。

例

files:write が必要。本文は省略できる。domain はリンクを配信するファイルホストのドメインを指定する。たとえば files.acme.com なら acme.com。応答は新しいリンクを含む 201。

curl

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 で拒否される。

呼び出すたびに、独自のダウンロード数を持つ新しいリンクが作られる。そのため、応答が失われた後に再試行すると 2 つ目のリンクができる。再試行の前に GET /files/{id}/links でリンクを一覧表示すること。

リンクは、取り消されるかファイルが削除されるまで有効である。