Belgelere geç
API

Kişi fotoğrafı ayarlama

Bir kişi için gösterilen fotoğrafı yükler ve varsa öncekinin yerini alır. Gövde JSON değil, görüntünün kendisidir ve türü `Content-Type` içinde yer alır: `image/png`, `image/jpeg`, `image/webp` ya da `image/gif`, en fazla 5 MB. 512 piksellik bir kareye sığdırılır ve WebP olarak saklanır, hareketli bir görüntünün ilk karesi kalır.

PUTapi.openemail.uk/contacts/{email}/photo

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

PUT /contacts/{email}/photo

Bir kişi için gösterilen fotoğrafı yükler ve varsa öncekinin yerini alır. Gövde JSON değil, görüntünün kendisidir ve türü Content-Type içinde yer alır: image/png, image/jpeg, image/webp ya da image/gif, en fazla 5 MB. 512 piksellik bir kareye sığdırılır ve WebP olarak saklanır, hareketli bir görüntünün ilk karesi kalır.

Örnek

contacts:write gerektirir. Adresin kayıtlı bir kişi olması gerekir, bu yüzden önce PUT /contacts/{email} ile kaydedin.

curl
curl -X PUT "$OE/contacts/grace%40example.com/photo" -H "$AUTH" -H 'content-type: image/jpeg' --data-binary @grace.jpg
Yanıt
{  "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" }  ]}

Kayıtlı kişi olmayan bir adres 404 contact_not_found olur. Kabul edilen türde bir görüntü olmayan, 5 MB'tan büyük olan ya da okunamayan bir gövde 422 invalid_image olur.

Aşırı yüklenmiş bir görüntü hizmeti 503 image_busy yanıtını verir, yeniden denemek güvenlidir. Her yükleme yeni bir photoUrl alır, bu yüzden önbellekteki eski bir fotoğraf yenisinin yerine asla görünmez.