يذكر كل استدعاء للذاكرة endUserId — مُعرّفك الثابت لمستخدمك (1–128 حرفاً، A-Za-z0-9@._-). لا يخزّنه Conare أبداً بصيغة صريحة: المستأجر الفعلي هو HMAC غير شفاف مُشتق من تكاملك ومن المُعرّف، ويستند العزل دائماً إلى الملخّص. تغطي هذه الصفحة عمليتَي دورة الحياة اللتين تملكهما — التسمية والحذف — إلى جانب كيفية تفاعل الاحتفاظ التلقائي مع الموصلات.
إرفاق هوية معروضة
افتراضياً، يعرض سجل المستخدمين النهائيين في لوحة التحكم لديك ملخّصات مُعتَّمة. ادفع اسماً معروضاً و/أو بريداً إلكترونياً ليعرض السجل أشخاصاً بدل ذلك:
أو باستخدام SDK:
الدلالات:
- تجميلي فقط. يبقى
endUserId مُلخَّصاً بـ HMAC على جانب Conare؛ يظل الاسترجاع والعزل والفوترة مستندة إلى الملخّص. هذه التسمية تغيّر فقط ما تراه أنت في السجل.
- تحديثات جزئية. أرسل نصاً لتعيين حقل، و
null لمسحه، واحذف المفتاح لتركه دون تغيير. قدّم على الأقل name أو email.
- الحدود.
name حتى 120 حرفاً، email حتى 254 حرفاً (يُفحص شكلاً للتحقق من @؛ لا فحص لإمكانية التسليم — أنت تملك نظافة عناوين مستخدميك).
- بلا احتساب. الاستدعاء مجاني ولا يُحسب نشاطاً للمستخدم النهائي، لذا فإن تسمية مستخدم خامل لن تمدّد نافذة الاحتفاظ الخاصة به.
متى تستخدمها: استدعِها كلما عرفت مسبقاً هوية معروضة لمستخدم — مثلاً، مباشرةً بعد تسجيله، أو عند إطلاق التكامل لأول مرة وأردت تعويض التسميات للمستخدمين الحاليين. إنها اختيارية؛ تخطّيها يترك السجل فقط يعرض الملخّصات.
حذف مستخدم نهائي (مسح GDPR)
DELETE /api/v1/users/{endUserId} هو إسقاط كامل ولا رجعة فيه. اربطه بتدفق حذف الحساب لديك.
في استدعاء واحد، يقوم Conare بـ:
- إبطال موارد مستوى الموصلات أولاً — تُفكَّك أي احتجازات OAuth وموارد الموصلات الخاصة بكل مستخدم قبل مسح الذاكرة. إن تعذّر الوصول إلى مستوى الموصلات، يعيد الاستدعاء
503 كي تستطيع إعادة المحاولة؛ فمسح يترك خلفه رمز OAuth حياً سيكون نجاحاً كاذباً.
- مسح مستوى الذاكرة — كل ذاكرة، وكل متجه، وكل حاوية لذلك المستخدم.
- إسقاط حالة الموصل — حالة الموصل الخاصة بالمستخدم المستخدمة لاستئناف المزامنات التزايدية.
- إزالة صف السجل — يختفي المستخدم من لوحة تحكم المستخدمين النهائيين لديك.
لا يمكن للمزامنات الخلفية الجارية أن تُحيي مستخدماً محذوفاً. إن كانت مزامنة موصل قيد التشغيل عند الحذف، فإن المزامنة تُجهَض في منتصف التنفيذ بدلاً من الكتابة في المستأجر الممسوح.
DELETE فوري دائماً ويشمل المستخدم بأكمله دائماً، بصرف النظر عن سياسة الاحتفاظ لديك. لا يوجد حذف ناعم ولا فترة سماح.
الاحتفاظ التلقائي
ضمن Platform → Retention يمكنك تعيين نافذة خمول قصوى. بمجرد ضبط نافذة، يُنقّي Conare تلقائياً أي مستخدم نهائي ظل خاملاً لفترة أطول منها — تُشغّل عملية التنقية نفس الإسقاط الكامل الذي يجريه DELETE /api/v1/users/{endUserId} الصريح (مستوى الذاكرة، حالة الموصل، صف السجل، إبطالات OAuth).
ما يُعدّ نشاطاً:
- أي استدعاء لواجهة API للشركاء يذكر المستخدم — بما في ذلك القراءات (
search، recall، suggestions) والكتابات (memories، containers).
- تُعدّ مزامنات الموصلات نشاطاً. يُحتفظ بمستخدم لديه موصل حيّ حتى تفصله. إن أردت تطبيق الاحتفاظ التلقائي على المستخدمين المتصلين، افصل الموصل أولاً (أو احذف المستخدم صراحةً).
ما لا يُعدّ نشاطاً:
PUT /api/v1/users/{endUserId} (تعيين الهوية المعروضة) — تسمية مستخدم خامل لا تمدّد الاحتفاظ.- عرض السجل في لوحة التحكم.
اترك الحقل فارغاً للاحتفاظ بالمستخدمين إلى الأبد. تُنفَّذ طلبات DELETE الصريحة دائماً على الفور بصرف النظر عن إعدادات الاحتفاظ. 