API

プロフィール写真を設定する

その人のプロフィール写真をアップロードし、既存のものを置き換える。本文は JSON ではなく画像そのもので、種類は `Content-Type` で指定する: `image/png`、`image/jpeg`、`image/webp`、`image/gif` のいずれかで、最大 5 MB。

PUTapi.openemail.uk/account/photo

実際の呼び出しをワークスペースに対して実行します。

PUT /account/photo

その人のプロフィール写真をアップロードし、既存のものを置き換える。本文は JSON ではなく画像そのもので、種類は Content-Type で指定する: image/png、image/jpeg、image/webp、image/gif のいずれかで、最大 5 MB。

account:write が必要。画像は 512 ピクセル四方に収められて WebP で保存され、アニメーション画像は最初のフレームが残る。新しい url を返す。

curl

curl -X PUT "$OE/account/photo" -H "$AUTH" -H "Content-Type: image/jpeg" --data-binary @me.jpg

レスポンス

{  "object": "account_photo",  "url": "https://cdn-prod.openemail.uk/users/avatars/8c1d4e7a-2f90-4b3c-a6d5-1e7f0b9c2d48.webp"}

受け付ける種類の画像でない、大きすぎる、または読み取れない本文は 422 invalid_image になる。画像サービスが混み合っているときは 503 image_busy になるので、もう一度試す。

アップロードのたびに新しい URL になるため、キャッシュされた古い写真が新しい写真の代わりに表示されることはない。