Files
buryan-agent 8b376d9c55 Сквозной поиск и карточка сущности с историей в API ядра
GET /search?q= — поиск по карточкам (название и внешние ключи).
GET /entity/{id} — карточка, её связи и история событий.

Проверено: поиск «дюна» вернул 3 карточки, карточка отдала историю
событий. Тестовые данные удалены, в ядре 68 настоящих карточек.

Попутно: datetimes ломали json.dumps — теперь сериализация с default=str,
иначе клиент получал пустой ответ.
2026-10-19 20:01:08 +03:00

36 lines
1.4 KiB
Markdown

# HTTP API ядра
Порт 9120, без авторизации (внутренняя сеть).
| Метод и путь | Что делает |
|---|---|
| `GET /` | HTML-панель состояния |
| `GET /health` | состояние и число событий |
| `POST /event` | принять событие от сервиса |
| `POST /entity` | создать/обновить карточку |
| `POST /link` | связать две карточки |
| `GET /search?q=` | сквозной поиск по карточкам |
| `GET /entity/{id}` | карточка + связи + история событий |
| `GET /entities?q=` | список карточек |
| `GET /events` | последние 30 событий |
## Примеры
```
curl -sG --data-urlencode "q=дюна" http://127.0.0.1:9120/search
curl -s http://127.0.0.1:9120/entity/74
```
Ответ `/search`:
```json
{"query": "дюна", "count": 3, "items": [
{"id": 74, "kind": "фильм", "title": "Дюна", "status": "media.imported",
"external_ids": {}, "updated_at": "2026-10-19 17:00:59"}]}
```
Ответ `/entity/74` — `card`, `links`, `history` (события этой карточки).
Важно: ответы сериализуются с `default=str`, иначе даты ломают JSON
(и клиент получает пустой ответ вместо данных).