Карта API

Общие правила

• Базовый префикс: /api/v2/storefront.
• Public endpoints возвращают только published/indexable данные.
• Editorial endpoints требуют authenticated actor и permission.
• Все write endpoints принимают Idempotency-Key, если могут повторяться.
• Preview endpoints не кешируются публичным CDN.
• Public form endpoints rate-limited и защищены spam policy.
• Ошибки возвращаются в общем API envelope.

Public API

Endpoint	Метод	Permission	Назначение
/pages/{slug}	GET	public	опубликованная страница
/catalog/items	GET	public	каталог, фильтры, сортировка
/catalog/items/{slug}	GET	public	карточка каталога
/collections/{slug}	GET	public	опубликованная подборка
/profiles/{slug}	GET	public	публичный профиль
/reviews	GET	public	опубликованные отзывы
/achievements	GET	public	опубликованные достижения
/facts	GET	public	опубликованные факты
/forms/{formKey}/submissions	POST	public rate-limited	заявка
/sitemap.xml	GET	public	sitemap
/redirects/resolve	GET	public/internal edge	resolve redirect

Pages и CMS

Endpoint	Метод	Permission	Назначение
/admin/pages	GET/POST	storefront.pages.read/manage	список и создание страниц
/admin/pages/{pageId}	GET/PATCH	storefront.pages.read/manage	карточка страницы
/admin/pages/{pageId}/versions	GET/POST	storefront.pages.read/manage	версии
/admin/page-versions/{versionId}/blocks	POST	storefront.pages.manage	добавить блок
/admin/blocks/{blockId}	PATCH/DELETE	storefront.pages.manage	изменить блок
/admin/page-versions/{versionId}/preview	GET	storefront.preview.read	preview
/admin/page-versions/{versionId}/publish	POST	storefront.pages.publish	публикация

Catalog

Endpoint	Метод	Permission	Назначение
/admin/catalog/items	GET/POST	storefront.catalog.read/manage	карточки
/admin/catalog/items/{itemId}	GET/PATCH	storefront.catalog.read/manage	карточка
/admin/collections	GET/POST	storefront.collections.read/manage	подборки
/admin/collections/{collectionId}/items	POST	storefront.collections.manage	добавить item
/admin/collections/{collectionId}/publish	POST	storefront.collections.publish	публикация

Profiles, reviews, achievements, facts

Endpoint	Метод	Permission	Назначение
/admin/profiles	GET/POST	storefront.profiles.read/manage	профили
/admin/profiles/{profileId}	GET/PATCH	storefront.profiles.read/manage	карточка профиля
/admin/reviews	GET/POST	storefront.reviews.read/manage	отзывы
/admin/reviews/{reviewId}/moderate	POST	storefront.moderation.manage	moderation decision
/admin/achievements	GET/POST	storefront.achievements.read/manage	достижения
/admin/achievements/{achievementId}/moderate	POST	storefront.moderation.manage	moderation decision
/admin/facts	GET/POST	storefront.facts.read/manage	факты
/admin/facts/{factId}/verify	POST	storefront.facts.verify	проверка факта

Campaigns, forms, SEO

Endpoint	Метод	Permission	Назначение
/admin/campaigns	GET/POST	storefront.campaigns.read/manage	кампании
/admin/forms	GET/POST	storefront.forms.read/manage	формы
/admin/form-submissions	GET	storefront.forms.read_submissions	заявки
/admin/form-submissions/{id}/retry-crm	POST	storefront.forms.manage	повторная отправка в CRM
/admin/redirects	GET/POST	storefront.seo.read/manage	redirects
/admin/redirects/{id}	PATCH/DELETE	storefront.seo.manage	изменить redirect
/admin/sitemap/rebuild	POST	storefront.seo.manage	пересобрать sitemap
/admin/audit-logs	GET	storefront.audit.read	audit

Error codes

Код	HTTP	Когда
storefront.page.not_found	404	page не найдена или не опубликована
storefront.page.not_publishable	409	version нельзя опубликовать
storefront.block.invalid	400	block props/data source невалидны
storefront.catalog.source_required	400	item без source/manual owner
storefront.moderation.required	409	entity требует moderation
storefront.consent.required	409	нет согласия на публикацию
storefront.fact.not_verified	409	факт не проверен
storefront.form.rate_limited	429	превышен rate limit
storefront.form.spam_rejected	400	spam policy отклонила заявку
storefront.redirect.unsafe	400	open redirect или цикл