API

Kişi güncelleme

Kısmi güncelleme, asla upsert değil. Göndermediğiniz bir alan saklanan değerini korur, açıkça verilen `null` ise onu temizler; yani `{"notes": null}` notları boşaltırken `{}` hiçbir şeyi değiştirmez. Defterde olmayan bir adres `404` verir.

PATCHapi.openemail.uk/contacts/{email}

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

PATCH /contacts/{email}

Kısmi güncelleme, asla upsert değil. Göndermediğiniz bir alan saklanan değerini korur, açıkça verilen null ise onu temizler; yani {"notes": null} notları boşaltırken {} hiçbir şeyi değiştirmez. Defterde olmayan bir adres 404 verir.

Örnek

contacts:write gerektirir. @ karakterini URL kodlamasıyla yazın.

curl

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

Yanıt

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

Adres buradan değiştirilemez. Adres hem kimlik, hem yol parçası, hem de defterin benzersiz anahtarıdır; bu yüzden bir kişiyi yeni bir adrese taşımak bir silme ve bir oluşturma demektir.

Otomatik olarak kaydedilen bir kişi, ona ad verdikten sonra da auto kalır. Ad vermek, birinin onu kaydetmiş olmasıyla aynı iddia değildir.

Kitle üyeliğine dokunulmaz. Bunun için kitle uç noktalarını kullanın.