Skip to main content

Інтеграція

Стабільна межа між вашим продуктом і Conare. Інтеграція належить вашій організації; окремі етапи розгортання (staging, prod) — це окремі інтеграції, розрізнені за slug. Кожна має власний ключ cint_... з явними скоупами (memory:read, memory:write, memory:delete).

Кінцеві користувачі

Кожен виклик до памʼяті містить endUserId (1–128 символів, A-Za-z0-9@._-) — ваш ідентифікатор вашого користувача. Це не простір імен: фізичний тенант — це непрозорий HMAC, похідний від вашої інтеграції та ID кінцевого користувача. Клієнти не можуть обирати простори імен або звертатися до іншого тенанта — за конструкцією.
  • Задавайте відображувану ідентичність через PUT /api/v1/users/{endUserId} (імʼя/email для перегляду в панелі).
  • DELETE /api/v1/users/{endUserId} — повне GDPR-стирання цього користувача.

Контейнери

Контейнери групують памʼять одного користувача за джерелом — наприклад, profile, claude-chats, saved або по одному на кожне підʼєднане джерело даних (тег контейнера = id конектора). Використовуйте containerTag під час збереження для впорядкування та DELETE /api/v1/containers/{containerTag}, щоб видалити памʼять одного джерела, не торкаючись решти.

Режими пошуку

Помилки та спостережуваність

Помилки використовують стабільну обгортку — { statusCode, code, message, requestId, details? } — і ніколи не розкривають внутрішні ID тенантів чи текст бекенду. Кожна відповідь містить X-Request-Id; надсилайте свій для наскрізної кореляції. Ліміти швидкості сигналізуються стандартними заголовками та 429; плани з журналом використання сигналізують вичерпаний ліміт через 402 плюс метадані балансу/скидання.