API

Atjaunināt kontaktu

Daļēja atjaunināšana, nekad ne upsert. Lauks, ko izlaižat, saglabā savu uzglabāto vērtību, un skaidri norādīts `null` to notīra, tāpēc `{"notes": null}` iztukšo piezīmes, bet `{}` nemaina neko. Adrese, kas nav grāmatā, ir `404`.

PATCHapi.openemail.uk/contacts/{email}

Izpilda īstu izsaukumu pret jūsu darbvietu, ar jūsu paša atslēgu.

PATCH /contacts/{email}

Daļēja atjaunināšana, nekad ne upsert. Lauks, ko izlaižat, saglabā savu uzglabāto vērtību, un skaidri norādīts null to notīra, tāpēc {"notes": null} iztukšo piezīmes, bet {} nemaina neko. Adrese, kas nav grāmatā, ir 404.

Piemērs

Nepieciešams contacts:write. Kodējiet @ URL formātā.

curl

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

Atbilde

{  "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" }  ]}

Adresi šeit nevar mainīt. Tā ir identitāte, ceļa segments un grāmatas unikālā atslēga, tāpēc kontakta pārvietošana uz jaunu adresi ir dzēšana un izveidošana.

Automātiski ierakstīts kontakts paliek auto arī pēc tam, kad esat tam devis vārdu. Vārda piešķiršana nav tas pats apgalvojums, ko kāda veikta saglabāšana.

Auditoriju dalība netiek aiztikta. Tam izmantojiet auditoriju maršrutus.