Kalo te dokumentacioni
API

Vendos foton e një kontakti

Ngarkon foton që shfaqet për një kontakt, duke zëvendësuar atë që kishte. Trupi është vetë imazhi, jo JSON, me llojin te `Content-Type`: `image/png`, `image/jpeg`, `image/webp` ose `image/gif`, deri në 5 MB. Përshtatet në një katror 512 pikselësh dhe ruhet si WebP, dhe nga një imazh i animuar mbetet kuadri i parë.

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

Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.

PUT /contacts/{email}/photo

Ngarkon foton që shfaqet për një kontakt, duke zëvendësuar atë që kishte. Trupi është vetë imazhi, jo JSON, me llojin te Content-Type: image/png, image/jpeg, image/webp ose image/gif, deri në 5 MB. Përshtatet në një katror 512 pikselësh dhe ruhet si WebP, dhe nga një imazh i animuar mbetet kuadri i parë.

Shembull

Kërkon contacts:write. Adresa duhet të jetë një kontakt i ruajtur, prandaj ruaje fillimisht me PUT /contacts/{email}.

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

Një adresë që nuk është kontakt i ruajtur është 404 contact_not_found. Një trup që nuk është imazh i një lloji të pranuar, është më i madh se 5 MB ose nuk mund të lexohet është 422 invalid_image.

Një shërbim imazhesh i mbingarkuar përgjigjet 503 image_busy, që mund të provohet sërish pa rrezik. Çdo ngarkim merr një photoUrl të ri, prandaj një foto e vjetër në memorien e përkohshme nuk shfaqet kurrë në vend të së resë.