گذاشتن عکس مخاطب
عکسی را که برای یک مخاطب نشان داده میشود بارگذاری میکند و جای عکس قبلی را میگیرد. بدنه خود تصویر است، نه JSON، و نوعش در `Content-Type` میآید: `image/png`، `image/jpeg`، `image/webp` یا `image/gif`، تا 5 MB. در مربعی ۵۱۲ پیکسلی جا داده و بهصورت WebP ذخیره میشود، و از تصویر متحرک قاب نخست میماند.
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
PUT /contacts/{email}/photo
عکسی را که برای یک مخاطب نشان داده میشود بارگذاری میکند و جای عکس قبلی را میگیرد. بدنه خود تصویر است، نه JSON، و نوعش در Content-Type میآید: image/png، image/jpeg، image/webp یا image/gif، تا 5 MB. در مربعی ۵۱۲ پیکسلی جا داده و بهصورت WebP ذخیره میشود، و از تصویر متحرک قاب نخست میماند.
نمونه
به contacts:write نیاز دارد. نشانی باید مخاطب ذخیرهشده باشد، پس ابتدا آن را با PUT /contacts/{email} ذخیره کنید.
curl -X PUT "$OE/contacts/grace%40example.com/photo" -H "$AUTH" -H 'content-type: image/jpeg' --data-binary @grace.jpg{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": null, "photoUrl": "https://cdn-prod.openemail.uk/contacts/photos/5b0e2c7a-91d4-4f3e-8a26-c4f1d9e07b3a.webp", "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-23T10:20:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" } ]}نشانیای که مخاطب ذخیرهشده نیست 404 contact_not_found است. بدنهای که تصویری از نوع پذیرفته نیست، از 5 MB بزرگتر است یا خوانده نمیشود 422 invalid_image است.
سرویس تصویر شلوغ با 503 image_busy پاسخ میدهد که تکرارش بیخطر است. هر بارگذاری photoUrl تازهای میگیرد، پس عکس کهنهٔ ماندگار در حافظهٔ نهان هرگز بهجای عکس تازه دیده نمیشود.