API

Ruaj një kontakt

Bën atë që bëjnë Shto te kontaktet dhe Mbaje te kontaktet në aplikacion, dhe është i sigurt në çfarëdo gjendje të jetë adresa. Një adresë që ende nuk është kontakt bëhet kontakt, me përgjigjen `201`. Një e regjistruar nga një dërgim bëhet `manual`, dhe një tashmë e ruajtur mban atë që ka, me përgjigjen `200`. Një adresë e fshirë kthehet. Trupi është opsional.

PUTapi.openemail.uk/contacts/{email}

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

PUT /contacts/{email}

Bën atë që bëjnë Shto te kontaktet dhe Mbaje te kontaktet në aplikacion, dhe është i sigurt në çfarëdo gjendje të jetë adresa. Një adresë që ende nuk është kontakt bëhet kontakt, me përgjigjen 201. Një e regjistruar nga një dërgim bëhet manual, dhe një tashmë e ruajtur mban atë që ka, me përgjigjen 200. Një adresë e fshirë kthehet. Trupi është opsional.

Shembull

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

curl

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

Përgjigje

{  "object": "contact",  "email": "[email protected]",  "name": "Grace Hopper",  "source": "manual",  "notes": null,  "photoUrl": null,  "lastSeenAt": "2026-09-20T12:00:00.000Z",  "createdAt": "2026-09-02T08:00:00.000Z",  "updatedAt": "2026-09-23T10:15:00.000Z",  "audiences": [    { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }  ]}

name zëvendëson emrin e ruajtur dhe mosdhënia e tij e mban. notes zëvendëson shënimet e ruajtura dhe null i pastron. Çdo çelës tjetër është 422 unknown_parameter.

Ndryshe nga POST /contacts, një adresë që është tashmë në libër nuk është 409; ndryshe nga PATCH, një adresë që s'është në libër nuk është 404. Një kontakt i ri hyn në audiencën e parazgjedhur.