Partner API — massabrutto.ru

API для партнёров

REST API для получения массы брутто и габаритов упаковки товаров. Данные собираются из 800+ тысяч товаров в базе знаний и дополняются AI-поиском из открытых источников.

Для доступа к API нужен ключ партнёра. Свяжитесь с нами для получения ключа.

Ключ передаётся в заголовке X-Partner-Key

Base URL

https://massabrutto.ru/api/v1/partner

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

Все запросы должны содержать заголовок X-Partner-Key.

# Пример заголовка
X-Partner-Key: ваш-ключ-партнёра
            

401

Ключ не передан

403

Невалидный ключ

429

Превышен лимит запросов

Эндпоинты

POST /lookup 100 req/min

Поиск массы и габаритов одного товара по названию.

Request Body

{
  "product_name": "Philips PerfectCare Elite Plus GC9682/80"
}
                        

Response (found)

{
  "success": true,
  "product_name": "Philips PerfectCare Elite Plus GC9682/80",
  "found": true,
  "data": {
    "gross_weight_kg": 8.5,
    "net_weight_kg": null,
    "package_length_cm": 50.0,
    "package_width_cm": 35.0,
    "package_height_cm": 30.0,
    "volume_m3": 0.0525,
    "confidence": 85,
    "sources_count": 3,
    "image_url": "https://..."
  }
}
                        

Response (not found)

{
  "success": true,
  "product_name": "Неизвестный товар XYZ",
  "found": false,
  "data": null
}
                        

POST /lookup/batch 10 req/min, max 50 items

Поиск массы и габаритов нескольких товаров за один запрос.

Request Body

{
  "products": [
    "Philips PerfectCare Elite Plus GC9682/80",
    "KARCHER Puzzi 10/1",
    "Miele Blizzard CX1 Cat & Dog"
  ]
}
                        

Response

{
  "success": true,
  "total": 3,
  "found_count": 2,
  "results": [
    { "success": true, "product_name": "...", "found": true, "data": { ... } },
    { "success": true, "product_name": "...", "found": true, "data": { ... } },
    { "success": true, "product_name": "...", "found": false, "data": null }
  ]
}
                        

GET /status 60 req/min

Проверка доступности API и текущих лимитов.

Response

{
  "status": "ok",
  "kb_products": 804000,
  "rate_limit_per_minute": 100,
  "batch_max_items": 50
}
                        

Примеры кода

# Поиск одного товара
curl -X POST https://massabrutto.ru/api/v1/partner/lookup \
  -H "Content-Type: application/json" \
  -H "X-Partner-Key: YOUR_API_KEY" \
  -d '{"product_name": "Philips GC9682/80"}'

# Batch-поиск
curl -X POST https://massabrutto.ru/api/v1/partner/lookup/batch \
  -H "Content-Type: application/json" \
  -H "X-Partner-Key: YOUR_API_KEY" \
  -d '{"products": ["Philips GC9682/80", "KARCHER Puzzi 10/1"]}'

# Проверка статуса API
curl -H "X-Partner-Key: YOUR_API_KEY" \
  https://massabrutto.ru/api/v1/partner/status
                

Описание полей

Поле	Тип	Описание
gross_weight_kg	float \| null	Масса брутто (с упаковкой), кг
net_weight_kg	float \| null	Масса нетто (без упаковки), кг. Часто null
package_length_cm	float \| null	Длина упаковки, см
package_width_cm	float \| null	Ширина упаковки, см
package_height_cm	float \| null	Высота упаковки, см
volume_m3	float \| null	Объём упаковки, м³ (вычисляется из габаритов)
confidence	int 0-100	Уверенность в данных (чем выше — тем надёжнее)
sources_count	int	Количество подтверждающих источников
image_url	string \| null	URL изображения товара

Лимиты

100

запросов/мин
POST /lookup

запросов/мин
POST /lookup/batch

товаров макс.
в одном batch

Получить API-ключ

Для получения ключа партнёра напишите в Telegram: @Jan_nox