BLOG / schema-valid-but-not-published-ready.mdx
Схема валидна, но публикация не готова: 10 ошибок доставки SKU.md
Десять точных сбоев между локальной проверкой схемы и публично корректным ресурсом SKU.md с последовательным исправлением.
Успешная проверка схемы отвечает только за локальную структуру. Публичный ресурс может вернуть неправильный адрес, статус, тип, байты или граф.
SKU.md — это размещаемый самим продавцом слой для обнаружения товаров и стабильных знаний о товарах. Он помогает агентам находить товары, понимать факты с указанием источников и знать, где повторно проверять актуальные коммерческие данные. Это не новый протокол Checkout.
Десять ошибок доставки
| № | Ошибка | Однозначная проверка |
|---|---|---|
| 1 | Неправильный статус | Требовать точный HTTP 200 |
| 2 | Перенаправление | Отключить редиректы и проверить исходный URL |
| 3 | Неправильный MIME | Требовать text/markdown с допустимыми параметрами |
| 4 | Мягкая подмена | Отклонить HTML или байты главной страницы |
| 5 | Ошибка канонического адреса | Сопоставить метаданные с запрошенным URL |
| 6 | Расхождение тела | Сравнить принятые байты и структурированные поля |
| 7 | Неработающие ссылки | Безопасно запросить обязательные ресурсы |
| 8 | Разорванный граф | Пройти от /sku.md по связям parent |
| 9 | Неверная версия | Требовать sku.md/0.10-draft и нужную схему |
| 10 | Нет онлайн-проверки | Выполнить published_resource и document_graph |
Последовательность диагностики
- Запросить точный HTTPS URL без следования редиректам.
- Проверить HTTP, MIME и совпадение байтов.
- Сопоставить канонический адрес, версию, идентичность и тело.
- Обойти обязательные ссылки и родительскую цепочку.
- Убедиться, что неизвестные пути дают точный 404.
- Повторить после очистки CDN и сохранить доказательства проверки.
Почему локальный сигнал недостаточен
Читаемая страница может быть HTML-представлением совместимости; завершенное развертывание может обслуживать старый кэш; один работающий URL товара не доказывает корневой манифест и соседние документы. Даже точный HTTP 200 бесполезен, если сервер возвращает домашнюю страницу с неверным MIME. Поэтому сетевой контракт должен проверять положительные и отрицательные случаи.
Ремонт без потери последней версии
Сначала сохраните последний принятый документ, исправьте маршрут или заголовки в отдельной среде и только затем замените ресурс. Не скрывайте ошибку редиректом и не меняйте канонический адрес ради прохождения теста. После исправления повторите все три области: offline_document, published_resource и document_graph, сверяясь с текстом спецификации v0.10.
Дополнительные материалы
Примените точное руководство по публикации и разделение живых данных.