Загрузить изображение бренда
Загружает одно изображение бренда вместо прежнего и возвращает бренд. Тело запроса это само изображение, а не JSON.
Выполняет настоящий запрос в вашем рабочем пространстве.
PUT /branding/images/{variant}
Загружает одно изображение бренда вместо прежнего и возвращает бренд. Тело запроса это само изображение, а не JSON.
Четыре изображения
| variant | Что это | Форматы | Как хранится |
|---|---|---|---|
| mark | Квадратный значок | SVG, PNG, JPEG, WebP | WebP, не больше 512 × 512 |
| wordmark | Логотип | SVG, PNG, JPEG, WebP | WebP, не больше 1024 × 256 |
| wordmark-dark | Логотип для тёмной темы | SVG, PNG, JPEG, WebP | WebP, не больше 1024 × 256 |
| login-background | Фото под страницей входа | PNG, JPEG, WebP, GIF | WebP, не больше 2560 × 1600 |
Отправьте байты с их типом в Content-Type. Принимается до 5 МБ. SVG превращается в растровое изображение, а у анимированного изображения остаётся первый кадр.
Пример
Требуется settings:write и ключ без ограничения по адресам или доменам.
curl -X PUT "$OE/branding/images/login-background" -H "$AUTH" \ -H "Content-Type: image/jpeg" --data-binary @lobby.jpg{ "object": "branding", "editable": true, "images": { "mark": "https://cdn-prod.openemail.uk/workspaces/icons/0199a1c2-7d4e-7a31-9b52-3c8e1f0a6d24.webp", "wordmark": "https://cdn-prod.openemail.uk/workspaces/wordmarks/0199a1c2-8b10-7e45-a2f1-6d9c3b7e0f58.webp", "wordmarkDark": null, "loginBackground": "https://cdn-prod.openemail.uk/workspaces/login-backgrounds/0199a1c3-0f2e-7c61-8d4a-5b1e9f7a2c36.webp" }, "fonts": { "primary": "inter", "secondary": "georgia" }, "loginBackground": { "kind": "image", "preset": "dusk", "color": null }}Загрузка фото страницы входа заодно переключает страницу входа на него.
Изображение типа, который этот вариант не принимает, или нечитаемое изображение получает ответ 422 invalid_image. Занятый сервис изображений отвечает 503 image_busy, а неудачное сохранение 502 image_not_stored, поэтому повторите попытку.