پرش به مستندات
API

به‌روزرسانی یک مخاطب

یک به‌روزرسانی جزئی، هرگز upsert. فیلدی که جا بگذارید مقدار ذخیره‌شده‌اش را نگه می‌دارد و یک `null` صریح پاکش می‌کند، پس `{"notes": null}` یادداشت‌ها را خالی می‌کند در حالی که `{}` چیزی را عوض نمی‌کند. نشانی‌ای که در دفترچه نیست `404` می‌گیرد.

PATCHapi.openemail.uk/contacts/{email}

فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا می‌کند.

PATCH /contacts/{email}

یک به‌روزرسانی جزئی، هرگز upsert. فیلدی که جا بگذارید مقدار ذخیره‌شده‌اش را نگه می‌دارد و یک null صریح پاکش می‌کند، پس {"notes": null} یادداشت‌ها را خالی می‌کند در حالی که {} چیزی را عوض نمی‌کند. نشانی‌ای که در دفترچه نیست 404 می‌گیرد.

نمونه

به contacts:write نیاز دارد. @ را URL-encode کنید.

curl
curl -X PATCH "$OE/contacts/grace%40example.com" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Grace Hopper",  "notes": null}'
پاسخ
{  "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" }  ]}

نشانی را از اینجا نمی‌توان عوض کرد. نشانی هم هویت است، هم بخش مسیر و هم کلید یکتای دفترچه، پس بردن یک مخاطب به نشانی تازه یعنی یک حذف و یک ساخت.

مخاطبی که خودکار ثبت شده پس از آنکه نامی به او بدهید هم auto می‌ماند. نام‌گذاری‌اش همان ادعایی نیست که کسی او را ذخیره کرده باشد.

عضویت در گروه‌های مخاطبان دست‌نخورده می‌ماند. برای آن از مسیرهای گروه مخاطبان استفاده کنید.