إنشاء جهة اتصال
يحفظ عنوانًا واحدًا في دفتر عناوين مساحة العمل. العنوان هو الهوية، فلا يوجد معرّف تختاره ولا معرّف في الاستجابة. تُقتطع مسافاته ويُحوَّل إلى أحرف صغيرة قبل تخزينه، وتُحفظ جهة الاتصال وقيمة `source` فيها `manual`. وتنضم جهة الاتصال الجديدة إلى الجمهور الافتراضي المدمج لحظة كتابتها، إضافة إلى كل ما يُذكر في `audienceIds`.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
POST /contacts
يحفظ عنوانًا واحدًا في دفتر عناوين مساحة العمل. العنوان هو الهوية، فلا يوجد معرّف تختاره ولا معرّف في الاستجابة. تُقتطع مسافاته ويُحوَّل إلى أحرف صغيرة قبل تخزينه، وتُحفظ جهة الاتصال وقيمة source فيها manual. وتنضم جهة الاتصال الجديدة إلى الجمهور الافتراضي المدمج لحظة كتابتها، إضافة إلى كل ما يُذكر في audienceIds.
مثال
يتطلب contacts:write. وإرسال audienceIds يتطلب كذلك audiences:write.
curl -X POST "$OE/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{ "email": "[email protected]", "name": "Grace Hopper", "notes": "Met at the compiler workshop"}'{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": "Met at the compiler workshop", "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-18T09:00:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" } ]}العنوان الموجود في الدفتر مسبقًا هو 409 contact_exists لا عملية دمج، حتى لا تستطيع إعادة محاولة أن تطمس بهدوء اسمًا حرّره أحدهم في التطبيق. اقرأ الصف وطبّق PATCH عليه بدلًا من ذلك.
تبقى lastSeenAt فارغة حتى يذهب بريد إلى العنوان من مؤلّف الرسائل في التطبيق. وsource وlastSeenAt يخصان الخادم ولا يُقبلان في جسم الطلب.
معرّف جمهور في audienceIds غير موجود في مساحة العمل هذه هو 404 ولا يُكتب شيء.