API

Përditësoni një kontakt

Një përditësim i pjesshëm, kurrë një upsert. Një fushë që e lini jashtë ruan vlerën e saj të regjistruar dhe një `null` i shprehur e pastron atë, prandaj `{"notes": null}` i zbraz shënimet ndërsa `{}` nuk ndryshon asgjë. Një adresë që nuk është në libër është `404`.

PATCHapi.openemail.uk/contacts/{email}

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

PATCH /contacts/{email}

Një përditësim i pjesshëm, kurrë një upsert. Një fushë që e lini jashtë ruan vlerën e saj të regjistruar dhe një null i shprehur e pastron atë, prandaj {"notes": null} i zbraz shënimet ndërsa {} nuk ndryshon asgjë. Një adresë që nuk është në libër është 404.

Shembull

Kërkon contacts:write. Kodojeni @ për URL.

curl

curl -X PATCH "$OE/contacts/grace%40example.com" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Grace Hopper",  "notes": null}'

Përgjigje

{  "object": "contact",  "email": "[email protected]",  "name": "Grace Hopper",  "source": "manual",  "notes": null,  "lastSeenAt": null,  "createdAt": "2026-09-18T09:00:00.000Z",  "updatedAt": "2026-09-18T09:04:00.000Z",  "audiences": [    { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }  ]}

Adresa nuk mund të ndryshohet këtu. Ajo është identiteti, segmenti i shtegut dhe çelësi unik i librit, prandaj zhvendosja e një kontakti në një adresë të re është një fshirje dhe një krijim.

Një kontakt i regjistruar automatikisht mbetet auto edhe pasi t’i jepni një emër. Emërtimi i tij nuk është i njëjti pohim si fakti që dikush e ka ruajtur.

Anëtarësimi në audienca nuk preket. Për atë përdorni rrugët e audiencave.