تخطَّ إلى المستندات
API

اضبط صورة ملفك الشخصي

يرفع صورة الملف الشخصي للشخص، فيستبدل أي صورة كانت. جسم الطلب هو الصورة نفسها، لا JSON، ونوعها في `Content-Type`: `image/png` أو `image/jpeg` أو `image/webp` أو `image/gif`، حتى 5 ميغابايت.

PUT/account/photo

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

PUT /account/photo

يرفع صورة الملف الشخصي للشخص، فيستبدل أي صورة كانت. جسم الطلب هو الصورة نفسها، لا JSON، ونوعها في Content-Type: image/png أو image/jpeg أو image/webp أو image/gif، حتى 5 ميغابايت.

مثال

يتطلب 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 جديد، لذا لا تظهر أبدًا صورة قديمة مخزّنة مؤقتًا مكان الجديدة.

المرجع