Прямое чтение в ChatGPT и Claude
Для поиска с переходом в карточку используйте HTML-поиск с обычными ссылками. Выдача, фильтры и ссылки на следующие страницы формируются на сервере и доступны без JavaScript. Откройте найденную ссылку на карточку или её характеристики в JSON; адрес товара не нужно передавать в запросе отдельно.
Для программного чтения используйте /catalog/*.json. Если веб-инструмент отклоняет переход к адресу из JSON, откройте HTML-выдачу из поля browseUrl и перейдите по обычной ссылке результата. Для /api/v1/catalog существуют равнозначные JSON-адреса вне /api/.
Когда использовать
Поиск арматуры, труб, листов и другого металлопроката в Алматы с доставкой по Казахстану. Сопоставление размеров, марки стали и стандарта со спецификацией. Ответы содержат ссылки на исходные карточки товаров.
Цены и текущие остатки не публикуются: их подтверждает менеджер. Значение price: null не означает нулевую цену. Разные варианты длины сохраняются в исходном обозначении. Неизвестные числовые характеристики возвращаются как null.
Быстрый старт
- Получить категории и их slug.
- Найти арматуру диаметром 12 мм и перейти по ссылке результата. Тот же поиск в JSON.
- Открыть HTML-карточку или ссылку «Характеристики в JSON» из выдачи. Проверить размер, сталь, стандарт и длину.
- Для коммерческого предложения перейти в контакты или написать на info@kazgroupmetal.kz.
Документация и форматы
OpenAPI 3.1 · Инструкция с примерами · Полный JSON-каталог · Указатель разделов.
Все методы используют GET или HEAD, без регистрации и ключа. Поиск: q, category, steel, standard, diameter, thickness, width, length. Числовые размеры задаются в миллиметрах. limit от 1 до 50, offset от 0; для продолжения используйте поле next. Обычные страницы по тем же адресам доступны с заголовком Accept: text/markdown. Они содержат тот же опубликованный текст, что HTML.
В JSON поле dataUrl содержит ссылку на данные товара, url — на HTML-карточку, browseUrl — на HTML-поиск с теми же фильтрами. При веб-чтении предпочитайте обычные ссылки HTML-выдачи; для API-клиентов используйте dataUrl. Отдельные числа в запросе сопоставляются с размером товара: «арматура 16» не подбирает другие диаметры по году 2016 в ГОСТ, а «арматура А500С 12 мм» не совпадает с длиной 12 м. Номер стандарта указывайте как «ГОСТ 8240». Для точного отбора по отдельной характеристике задавайте diameter, width, thickness и length. Адреса не нужно угадывать или составлять из названия.
JSON-выдача также содержит массив links: rel=item указывает на JSON выбранных товаров, rel=self — на текущую выдачу, rel=next — на продолжение. Поле navigation дублирует ссылки на товары с подписями в Markdown внутри JSON. Ссылки доступны и в HTTP-заголовке Link; полный список всегда находится в теле ответа. Формат остаётся application/json, включая запросы с Accept: text/html.
Ошибки и устойчивость
Пустой поиск — HTTP 200 и total: 0. Неверный фильтр — 400 INVALID_ARGUMENT. Отсутствующий товар или метод — 404 NOT_FOUND. Запись запрещена: 405 METHOD_NOT_ALLOWED. Ошибки имеют формат application/problem+json, поля code, title, detail и ссылку на документацию.
Сохраняйте результаты у себя, используйте пагинацию и не более двух параллельных запросов. При ответе 429 или 503 повторяйте запрос позже, учитывая Retry-After, если он указан. Фиксированная квота API не объявлена; защита платформы может ограничивать нагрузку.
Версии
Текущий интерфейс — v1: /api/v1/catalog. Новые поля могут добавляться без изменения версии. Несовместимые изменения публикуются под новым номером. Объявления об устаревании будут публиковаться здесь; при назначении даты отключения будут использоваться заголовки Deprecation и Sunset. На данный момент отключение v1 не назначено. Ранее опубликованные адреса /catalog/*.json сохраняются.
Доступ не даёт прав на админку, черновики, почту или отправку заявок. Подключение к ChatGPT, Claude, Codex и другим системам выполняется средствами выбранного инструмента; этот сайт не подключает аккаунты автоматически.