بارگذاری تصویر برند
یک تصویر برند را بارگذاری میکند که جای تصویر قبلی را میگیرد، و برند را برمیگرداند. بدنه خودِ تصویر است، نه 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 میدهد، پس دوباره امتحان کنید.