حفظ جهة اتصال
يفعل ما يفعله إضافة إلى جهات الاتصال والإبقاء في جهات الاتصال في التطبيق، وهو آمن أيًّا كانت حالة العنوان. فالعنوان الذي ليس جهة اتصال بعد يصبح جهة اتصال، ويكون الرد `201`. والعنوان المسجّل من إرسال يصبح `manual`، والمحفوظ مسبقًا يحتفظ بما لديه، ويكون الرد `200`. والعنوان المحذوف يعود. والجسم اختياري.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
PUT /contacts/{email}
يفعل ما يفعله إضافة إلى جهات الاتصال والإبقاء في جهات الاتصال في التطبيق، وهو آمن أيًّا كانت حالة العنوان. فالعنوان الذي ليس جهة اتصال بعد يصبح جهة اتصال، ويكون الرد 201. والعنوان المسجّل من إرسال يصبح manual، والمحفوظ مسبقًا يحتفظ بما لديه، ويكون الرد 200. والعنوان المحذوف يعود. والجسم اختياري.
مثال
يتطلب contacts:write. ورمّز @ ضمن الـ URL.
curl -X PUT "$OE/contacts/grace%40example.com" -H "$AUTH" -H 'content-type: application/json' -d '{ "name": "Grace Hopper"}'{ "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 الاسم المحفوظ، وإغفاله يُبقيه. ويستبدل notes الملاحظات المحفوظة، وnull يمحوها. وأي مفتاح آخر هو 422 unknown_parameter.
بخلاف POST /contacts، لا يكون العنوان الموجود في الدفتر 409؛ وبخلاف PATCH، لا يكون العنوان غير الموجود في الدفتر 404. وتنضم جهة الاتصال الجديدة إلى الجمهور الافتراضي.