HTTP API

Базовый URL

К путям ниже добавляйте свой домен. В продакшене совпадает с публичным origin сайта.

https://westden4ik.sviridoff.space/api/v1

MCP-сервер для Cursor

Готовые бинарники, которые ходят в это же API (посты, проекты, книги, услуги, опционально CRM). Тот же стек, что и у живого сайта.

Скачать сборки

Админка и клиентский портал (/api/v1/admin/*, /api/v1/client/*) требуют авторизации и здесь не перечислены — см. README репозитория и пакет packages/mcp-server.

Посты и вовлечённость

GET/api/v1/posts
Список опубликованных постов с пагинацией. Query: page, pageSize, type (TEXT|VIDEO|IMAGE), tag, q, publishedFrom, publishedTo, hasCode.
GET/api/v1/posts/{slug}
Один пост: тело, метки, навигация по серии, счётчики лайков.
GET/api/v1/posts/{slug}/comments
Одобренные комментарии (дерево). Query: commentsPage, commentsPageSize, commentsSort.
POST/api/v1/posts/{slug}/comments
Отправить комментарий на модерацию.
POST/api/v1/posts/{slug}/like
Лайк поста (учёт cookie/сессии).
DELETE/api/v1/posts/{slug}/like
Снять лайк.

Проекты, книги, фото

GET/api/v1/projects
Проекты с пагинацией. Query: page, pageSize, tag.
GET/api/v1/books
Книги с пагинацией. Query: page, pageSize, tag.
GET/api/v1/photos
Фото / галерея с пагинацией и опциональной меткой.

Услуги и сайт

GET/api/v1/services
Карточки услуг (цены, сроки и т.д.).
GET/api/v1/services-page
Тексты публичной страницы услуг из CMS (герой, процесс, CTA, переводы).
POST/api/v1/services/inquiries
Заявка на услугу: email, сообщение, опционально Telegram и serviceId.
GET/api/v1/site-settings
Публичные строки брендинга и внешние ссылки подвала.
GET/api/v1/about
Данные страницы «О себе» (HTML, портрет).

Поиск и аналитика

GET/api/v1/search
Поиск по постам, проектам и книгам. Query: q (обязательно), page, pageSize.
GET/api/v1/tags/{resource}
Счётчики меток для облаков. resource = posts | projects | photos | books.
GET/api/v1/post-series/{slug}
Навигация по серии постов.
POST/api/v1/engagement
Лёгкая аналитика (просмотр поста, клики по внешним ссылкам). С rate limit.