v1.4.2

Stroymat API

REST-интерфейс для интеграции с каталогом стройматериалов, ценами, остатками на складах и оформлением заказов. Для партнёров и B2B-интеграций.

Все системы работают штатно

Базовый URL

https://api.stroymatdv.cc/v1
Все запросы — по HTTPS. Ответы в формате JSON (UTF-8). Версия API передаётся в пути.

Аутентификация

Каждый запрос требует персональный API-ключ в заголовке Authorization:

Authorization: Bearer sk_live_<ваш_ключ>
Content-Type: application/json
Ключи выпускаются в личном кабинете партнёра. Запросы без ключа возвращают 401 Unauthorized.

Эндпоинты

МетодПутьОписание
GET/v1/catalogДерево категорий каталога
GET/v1/productsСписок товаров (пагинация, фильтры)
GET/v1/products/{id}Карточка товара
GET/v1/stockОстатки по складам
GET/v1/pricesЦены и спецпредложения
POST/v1/ordersСоздать заказ
GET/v1/orders/{id}Статус заказа

Пример запроса

curl https://api.stroymatdv.cc/v1/products?category=cement&limit=20 \
  -H "Authorization: Bearer sk_live_..."

Лимиты

1000 запросов/час на ключ. Текущий остаток — в заголовках X-RateLimit-Remaining.

Версионирование

Актуальная версия — v1. Изменения — в журнале обновлений. Обратная совместимость в рамках мажорной версии.