تحديث جهة اتصال
تحديث جزئي، وليس إدراجًا مع تحديث أبدًا. الحقل الذي تتركه يحتفظ بقيمته المخزّنة، و`null` الصريحة تمسحه، فـ `{"notes": null}` تُفرّغ الملاحظات بينما `{}` لا تغيّر شيئًا. والعنوان غير الموجود في الدفتر هو `404`.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
PATCH /contacts/{email}
تحديث جزئي، وليس إدراجًا مع تحديث أبدًا. الحقل الذي تتركه يحتفظ بقيمته المخزّنة، وnull الصريحة تمسحه، فـ {"notes": null} تُفرّغ الملاحظات بينما {} لا تغيّر شيئًا. والعنوان غير الموجود في الدفتر هو 404.
مثال
يتطلب contacts:write. ورمّز @ ضمن الـ URL.
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 بعد أن تمنحها اسمًا. فتسميتها ليست الادعاء نفسه الذي يعنيه حفظ أحدهم لها.
عضوية الجمهور لا تُمَس. استخدم مسارات الجمهور لذلك.