API
연락처 사진 설정
연락처에 표시할 사진을 올리고 기존 사진을 대체합니다. 본문은 JSON이 아니라 이미지 자체이며, 형식은 `Content-Type`에 `image/png`, `image/jpeg`, `image/webp`, `image/gif` 중 하나로 지정하고 최대 5 MB입니다. 512픽셀 정사각형에 맞춰 WebP로 저장하며, 애니메이션 이미지는 첫 프레임만 남깁니다.
PUTapi.openemail.uk/contacts/{email}/photo
본인 키로 워크스페이스에 실제 호출을 실행합니다.
PUT /contacts/{email}/photo
연락처에 표시할 사진을 올리고 기존 사진을 대체합니다. 본문은 JSON이 아니라 이미지 자체이며, 형식은 Content-Type에 image/png, image/jpeg, image/webp, image/gif 중 하나로 지정하고 최대 5 MB입니다. 512픽셀 정사각형에 맞춰 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을 받으므로, 캐시된 옛 사진이 새 사진 대신 보이는 일은 없습니다.