Публичный API предоставляет доступ к данным энциклопедии в формате JSON. Базовый URL: https://wiki.provladimir.ru/api/v1/kb/public
GET/api/v1/kb/public/entities
Список сущностей с пагинацией и фильтрацией
| Параметр | Тип | Описание |
|---|
entity_type | string? | Фильтр по типу: person, organization, place |
limit | int | Количество (1-100, по умолчанию 50) |
offset | int | Смещение (по умолчанию 0) |
order_by | string | Сортировка: mention_count (по умолчанию), name, created_at |
Пример:/api/v1/kb/public/entities?entity_type=person&limit=10
GET/api/v1/kb/public/entities/search
Поиск сущностей по имени (нечёткий, pg_trgm)
| Параметр | Тип | Описание |
|---|
q | string | Поисковый запрос (обязательный) |
entity_type | string? | Фильтр по типу |
limit | int | Количество (1-50, по умолчанию 20) |
Пример:/api/v1/kb/public/entities/search?q=Орлова
GET/api/v1/kb/public/entities/{id}
Детальная информация о сущности: профиль, алиасы, даты публикаций, юридический статус
Пример:/api/v1/kb/public/entities/df0d0b6d-613f-4c10-9051-914354d753a2
GET/api/v1/kb/public/entities/{id}/articles
Статьи, в которых упоминается сущность
| Параметр | Тип | Описание |
|---|
limit | int | Количество (1-100, по умолчанию 20) |
offset | int | Смещение (по умолчанию 0) |
GET/api/v1/kb/public/entities/{id}/related
Связанные сущности (по совместному упоминанию в статьях)
| Параметр | Тип | Описание |
|---|
limit | int | Количество (1-30, по умолчанию 10) |
GET/api/v1/kb/public/entities/{id}/mentions
Упоминания сущности с контекстом (статья, позиция в тексте)
| Параметр | Тип | Описание |
|---|
limit | int | Количество (1-50, по умолчанию 20) |
offset | int | Смещение (по умолчанию 0) |
GET/api/v1/kb/public/entities/{id}/timeline
Помесячная статистика упоминаний сущности
GET/api/v1/kb/public/stats
Общая статистика базы знаний: количество статей, сущностей, упоминаний