GET /search?q= — поиск по карточкам (название и внешние ключи).
GET /entity/{id} — карточка, её связи и история событий.
Проверено: поиск «дюна» вернул 3 карточки, карточка отдала историю
событий. Тестовые данные удалены, в ядре 68 настоящих карточек.
Попутно: datetimes ломали json.dumps — теперь сериализация с default=str,
иначе клиент получал пустой ответ.
36 lines
1.4 KiB
Markdown
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
|
|
(и клиент получает пустой ответ вместо данных).
|