Цены и остатки API v1

Контракт production v1 подтвержден 15 октября 2026 года. Эти отдельные маршруты реализованы в слое совместимости v2 и читают PostgreSQL.

Все запросы требуют Bearer JWT. Ответ сохраняет legacy envelope и HTTP 200, включая ошибки параметров. Примеры ниже сокращены из production-эталонов.

Выдаются розничная цена и, при наличии соответствующих прав, персональная. Типы значений сохраняются. Товар не найден: data=[] и сообщение в message.

GET /api/v1/get/item/:id/availability

GET /api/v1/get/item/57114409/availability

{
  "status": true,
  "data": {
    "id": 57114409,
    "shipping": {
      "name": "В пути",
      "value": null
    },
    "inStock": {
      "name": "В наличии",
      "value": 0,
      "field_id": 283,
      "uid": "common_quantity"
    },
    "stockNumber": {
      "name": "Артикул",
      "value": "6156782",
      "field_id": 102678,
      "uid": "artikul"
    },
    "price": {
      "name": "Розничная цена",
      "value": "1137.04",
      "field_id": 203252,
      "uid": "roznica_price"
    }
  },
  "error": {},
  "message": ""
}

GET /api/v1/get/items/availability/by-stock

GET /api/v1/get/items/availability/by-stock?stock_list=6121963,6156782

{
  "status": true,
  "data": [
    {
      "id": 935229,
      "shipping": {
        "name": "В пути",
        "value": null
      },
      "inStock": {
        "name": "В наличии",
        "value": 4,
        "field_id": 283,
        "uid": "common_quantity"
      },
      "stockNumber": {
        "name": "Артикул",
        "value": "6121963",
        "field_id": 102678,
        "uid": "artikul"
      },
      "price": {
        "name": "Розничная цена",
        "value": "0",
        "field_id": 203252,
        "uid": "roznica_price"
      },
      "warehouseList": [
        {
          "id": 302201,
          "name": "Санкт-Петербург",
          "value": 4
        }
      ]
    }
  ],
  "error": {},
  "message": ""
}

GET /api/v1/get/items/availability/from

GET /api/v1/get/items/availability/from?id_list=128491

{
  "status": true,
  "data": [
    {
      "id": 5366035,
      "shipping": {
        "name": "В пути",
        "value": null
      },
      "inStock": {
        "name": "В наличии",
        "value": 0,
        "field_id": 283,
        "uid": "common_quantity"
      },
      "stockNumber": {
        "name": "Артикул",
        "value": "6129678",
        "field_id": 102678,
        "uid": "artikul"
      },
      "price": {
        "name": "Розничная цена",
        "value": "0",
        "field_id": 203252,
        "uid": "roznica_price"
      }
    }
  ],
  "error": {},
  "message": ""
}