Справочник REST API

Все эндпоинты требуют Bearer-токен. Получите токен в панели управления.

# Базовый URL

https://api.agent-memo.ai

# Заголовок аутентификации

Authorization: Bearer YOUR_API_KEY

Записи памяти

GET/api/memories

Список записей с опциональными фильтрами

Query: ?topic=&type=&importance=&limit=&offset=

POST/api/memories

Создать новую запись

{ "content": "...", "type": "project", "topic": "auth", "importance": 2, "tags": ["decision"] }

GET/api/memories/:id

Получить запись по ID

PUT/api/memories/:id

Обновить существующую запись

{ "content": "updated content", "importance": 3 }

DELETE/api/memories/:id

Удалить запись

POST/api/memories/search

Семантический поиск по записям

{ "query": "database choice", "type": ["project"], "limit": 5 }

GET/api/memories/topics

Список тем с количеством записей

POST/api/memories/check-duplicate

Проверить семантические дубликаты перед сохранением

{ "content": "...", "threshold": 0.92 }

Граф знаний

POST/api/kg/add

Добавить связь сущностей (факт)

{ "subject": "auth-service", "predicate": "uses", "object": "JWT", "confidence": 0.95 }

POST/api/kg/query

Запросить связи сущностей

{ "entity": "auth-service", "direction": "outgoing" }

POST/api/kg/invalidate

Инвалидировать факт (отметить как более неактуальный)

{ "factId": "..." }

POST/api/kg/timeline

Просмотр временной линии фактов для сущности

{ "entity": "auth-service" }

GET/api/kg/stats

Статистика графа знаний

Формат ответа

Все ответы в формате JSON. Успешные ответы возвращают данные напрямую. Ошибки возвращают JSON-объект с полем error.

Успех (200)

{
  "id": "abc-123",
  "content": "Use PostgreSQL",
  "type": "project",
  "topic": "database",
  "importance": 3,
  "created_at": "2026-04-08T..."
}

Ошибка (4xx/5xx)

{
  "error": "Memory not found"
}

Ограничения частоты запросов

Во время бета-тестирования ограничения частоты не применяются. Будьте разумны — типичное использование значительно ниже 100 запросов в минуту. Ограничения будут введены с платными тарифами.