BIGCOMMERCE · SKU-MD v1.0.0-beta

Сначала опубликуйте минимальный корень, затем добавляйте только знания с источником

Введите общедоступную витрину или каталог либо одну общедоступную страницу товара. Сначала создайте минимальный корневой документ, затем при необходимости добавьте документ знаний о товаре со ссылкой Source.

Открыть генератор BigCommerce

Без учетных данных · Без закрытых API · Без массового обхода · Без автоматической публикации

BigCommerce занимается живой торговлей; SKU-MD содержит проверенные знания

Интеграция сохраняет динамические транзакции и надежные знания о продуктах в системах, которые действительно могут их поддерживать.

BIGCOMMERCE

Источник истины для текущей коммерции

Владеет текущими продуктами, вариантами, ценами в каналах, запасами, покупателями, корзинами, заказами и поведением при оформлении заказа.

SKU-MD

Минимальный контракт публичного документа

Публикует корень v1 по адресу /sku.md и при необходимости один необязательный документ знаний о товаре со ссылкой Source.

Текущий генератор использует только публичные доказательства

Этот процесс использует только общедоступные входные данные и локально созданные файлы.

01
Введите общедоступный URL
Укажите общедоступную витрину или каталог либо одну общедоступную страницу товара.
02
Создайте минимальный корень
Создайте и проверьте корень v1 до добавления необязательного документа.
03
Добавляйте только знания с источником
Для явно указанной страницы товара можно создать один необязательный документ знаний со ссылкой Source.
04
Опубликовать и проверить
Опубликуйте /sku.md, затем выполните проверки document, published и graph.

Возможности BigCommerce решают различные этапы жизненного цикла

Это задокументированные поверхности BigCommerce. Их перечисление не означает, что текущий общедоступный генератор вызывает их.

ОБЩЕСТВЕННЫЙ

Витрина, каталог или страница товара

Генератор читает только введенный пользователем общедоступный URL, не выводит другие товары и не обходит каталог.

ВИТРИНА МАГАЗИНА

GraphQL Storefront API

Запрашивает видимые продукты, варианты, цены, метаполя витрины, маршруты и контент. Запросы требуют соответствующего носителя token; текущий генератор не принимает ничего.

УПРАВЛЕНИЕ

REST Management API

Авторизованные учетные записи API могут управлять каталогом и хранить данные, используя учетные данные с ограниченной областью действия. Это будущие входные данные для синхронизации на стороне сервера, а не общедоступный источник браузера.

АУТ

Счета API и OAuth

Учетные записи на уровне магазина и приложения имеют доступ к областям token и OAuth. Секреты остаются на стороне сервера, и для этого требуется минимум привилегий.

СОБЫТИЯ

Webhooks

Доставка HTTPS, Pub/Sub или EventBridge может инициировать добавочное обновление. Получателям по-прежнему необходимы аутентификация, идемпотентность, обработка повторных попыток и согласование.

Интерфейс витрины магазина

Scripts API

Авторизованные приложения могут добавлять сценарии витрины с учетом каналов. Скрипты могут объявлять ссылки обнаружения, но код на стороне клиента не является запрошенным ответом Markdown.

ДОСТАВКА

Витрины магазинов Stencil и headless

Пользовательские шаблоны Stencil назначаются существующим типам страниц. Контролируемый продавцом headless или пограничный уровень может реализовать точный маршрут документа same-origin.

Проанализированные официальные источники не документируют принятие BigCommerce SKU-MD. Возможности платформы, совместимое обнаружение, строгое соответствие и действующий авторитет остаются отдельными требованиями.

Выбирайте доставку по ответу, который вы можете доказать

Сгенерированный Markdown одинаков в каждом режиме. Только развернутый маршрут определяет, является ли публикация совместимой или строгой.

ОТКРЫТИЕ

Stencil витрина магазина

Добавьте видимую или обнаруживаемую компьютером ссылку через тему, существующую страницу контента или скрипт, управляемый приложением.

Шаблоны Stencil отображают существующие типы страниц витрины; Scripts API устанавливает скрипты. Ни один из них сам по себе не доказывает ответ text/markdown по корневому пути.

СТРОГО КАНДИДАТ

Маршрут headless, контролируемый продавцом

Предоставляйте неизменяемые, предварительно проверенные файлы из приложения витрины, сохраняя при этом ссылки canonical и parent на один и тот же источник.

Требуйте точный HTTP 200, Content-Type: text/markdown, идентификатор байта, действительный граф документа, предсказуемую замену кэша и точный неизвестный файл 404.

СТРОГО КАНДИДАТ

Краевой маршрут того же происхождения

Обслуживайте сохраненные документы по адресу /sku.md и по путям к документам продуктов до того, как запросы достигнут размещенной витрины.

Правило маршрутизации не является доказательством. Проверяйте реальный отклик после каждого изменения публикации.

Режим	Что он может сделать	Граница доказательств
Stencil	Используйте тему, пользовательскую страницу или интеграцию Scripts API, чтобы предоставить рекомендации по обнаружению.	Только совместимое открытие; документированные поверхности не устанавливают произвольный ответ Markdown для корневого пути.
headless	Передавать принятые файлы из приложения витрины, контролируемого продавцом, в источнике магазина.	Строгий только после прохождения точного маршрута, типа носителя, байтов, графика, замены кэша и поведения 404.
Край	Перехватывайте пути документов same-origin перед размещенной витриной и возвращайте сохраненные принятые байты.	Строгий только после того, как публичный ответ будет проверен независимо от конфигурации.

Сохраняйте семейство документов v1 минимальным

Специальный генератор использует те же сборщики и валидатор v1, что и общий процесс.

Сначала минимальный корень

Создайте корень v1 с публичной идентификацией магазина и точкой входа каталога.

Один необязательный документ товара

Добавляйте знания только для одной общедоступной страницы товара, явно указанной пользователем.

Факты со ссылкой Source

Каждый факт ссылается на общедоступный Source; валидатор graph проверяет связи документов.

Консервативный объем

Если подходящих знаний с источником нет, сохраните действительный корень и не создавайте необязательный документ.

Проверяйте каждый объем публикации

Создание и публикация — разные шаги, поэтому каждому объему нужны отдельные доказательства.

document
Проверьте созданные байты
Запустите действующий валидатор документа v1 перед публикацией.
published
Проверьте публичный ответ
Проверьте статус, MIME и байты реального ответа /sku.md.
graph
Проверьте связи
Проверьте каждый связанный документ и отношение Source.
ПОВТОР
Повторите после изменения
Повторно запускайте все проверки при каждом изменении опубликованных файлов.

Текущий процесс не подключается к учетным записям BigCommerce и не публикует файлы автоматически.

Разрешения и ограничения текущей версии

Публичный рабочий процесс остается узким, контролируемым и контролируемым торговцами.

Нет входа в систему BigCommerce, учетной записи API, потока OAuth, доступа к token, витрины магазина token или частного token.
Никаких запросов REST Management API или GraphQL Storefront API и сканирования каталога.
Никакого заказа, клиента, корзины, оформления заказа, оплаты или личного доступа к продукту.
Никакой подписки Webhook, фоновой синхронизации, редактирования тем, установки сценариев или автоматического обновления.
Никаких изменений DNS, прокси-сервера, периферии, кэша или рабочей публикации.
Никаких претензий на поддержку BigCommerce, партнерство, официальную поддержку SKU-MD или выгоду от внедрения.

Взгляд со стороны бренда

Узнайте, что SKU.md дополняет в вашей платформе и как начать с одного товара.

Интеграция SKU.md с BigCommerce

Официальные источники проверены на 2026-08-07

Заявления о возможностях BigCommerce взяты с сайта docs.bigcommerce.com. Требования к доставке SKU-MD помечены отдельно как независимые правила проверки.

Быстрый старт для разработчиков ↗
Обзор платформы, песочница, учетные данные, точки входа REST и GraphQL.
Аккаунты API ↗
Типы учетных записей, доступ к token, области OAuth и границы аутентификации.
GraphQL Аутентификация витрины ↗
Требования token к витрине, частному лицу и клиенту.
Продукты GraphQL ↗
Видимые поля продукта, варианта, цены, метаполя и каталога.
Webhooks ↗
Механизмы доставки событий, обратные вызовы, повторные попытки, ограничения и безопасность.
Scripts API ↗
Установка сценариев с учетом каналов и ограничения витрины.
Пользовательские шаблоны Stencil ↗
Поддерживаемые типы страниц, назначения и границы сопоставления URL-адресов.
Маршруты headless ↗
GraphQL используется для обнаружения маршрутов продуктов, категорий, страниц, блогов и перенаправлений.
Контент сайта headless ↗
Страницы, отображаемые регионы, блоги, баннеры и поиск контента на основе маршрутов.

Часто задаваемые вопросы по интеграции BigCommerce

Генератор подключается к учетной записи BigCommerce?

Нет. Он читает общедоступный HTML и одну явную страницу продукта same-origin. У него нет входа в систему, потока token, OAuth или соединения BigCommerce API.

Почему бы не вызвать GraphQL Storefront API напрямую?

BigCommerce требует соответствующего носителя token. Публичный генератор намеренно не принимает учетные данные и не использует прокси-серверы частных token.

Может ли Stencil публиковать /sku.md напрямую?

Рассмотренная документация по пользовательским шаблонам охватывает существующие типы брендов, категорий, продуктов и страниц; он не устанавливает произвольный ответ Markdown по корневому пути.

Может ли Scripts API опубликовать файл?

Scripts API устанавливает сценарии витрины на стороне клиента. Сценарий может объявить ссылку обнаружения, но это не запрошенный ответ документа HTTP 200 text/markdown.

Что могут витрины headless?

Приложение headless, контролируемое продавцом, может реализовать этот маршрут, но строгая доставка существует только после того, как реальный ответ same-origin пройдет проверку статуса, MIME, байта, графа, кеша и 404.

Что генератор создает первым?

Он всегда сначала создает минимальный корень v1. Документ знаний о товаре со ссылкой Source необязателен.

Заменяет ли документ знаний текущий каталог?

Нет. Он содержит только явные факты со ссылкой Source и не несет текущих цен или запасов. Корзина, оформление заказа, оплата и заказы остаются в BigCommerce.

Официально ли BigCommerce поддерживает SKU-MD?

Ни один проверенный официальный источник об этом не говорит. Это независимое руководство сопоставляет документированные возможности BigCommerce с рабочим процессом, контролируемым продавцом; он не документирует официальное принятие BigCommerce SKU-MD.

Начните с публичных доказательств, а затем публикуйте только то, что вы можете проверить.

Создайте проверяемый черновик без учетных данных. Используйте Stencil для обнаружения, headless, контролируемый продавцом, или пограничный маршрут для проверяемой доставки Markdown.