Отдельная документация API v1

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

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

По артикулу этот API выбирает запись собственного хранилища документации. Ее productId может отличаться от /get/items/by-stock для того же артикула. Для неизвестного UMI id возвращается объект с исходным productId, stockNumber=null и пустым documentation.

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

GET /api/v1/get/item/57114409/documentation

{
  "status": true,
  "data": {
    "productId": 57114409,
    "stockNumber": "6156782",
    "documentation": [
      {
        "title": "Описание на сайте производителя",
        "url": "https://www.winmate.com/Product/E500RM9",
        "fileType": null,
        "size": null,
        "sizeBytes": null
      }
    ]
  },
  "error": {},
  "message": ""
}

GET /api/v1/get/items/documentation

GET /api/v1/get/items/documentation?id_list=935229,57114409

{
  "status": true,
  "data": [
    {
      "productId": 935229,
      "stockNumber": null,
      "documentation": []
    }
  ],
  "error": {},
  "message": ""
}

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

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

{
  "status": true,
  "data": [
    {
      "productId": 935768,
      "stockNumber": "6121963",
      "documentation": [
        {
          "title": "Datasheet (англ.)",
          "url": "https://nnz-ipc.ru/files/documentation/weintek/ir_datasheet.pdf",
          "fileType": "pdf",
          "size": null,
          "sizeBytes": null
        }
      ]
    }
  ],
  "error": {},
  "message": ""
}

GET /api/v1/get/items/documentation/from

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

{
  "status": true,
  "data": [
    {
      "productId": 5366035,
      "stockNumber": "6129678",
      "documentation": [
        {
          "title": "Datasheet (англ.)",
          "url": "https://nnz-ipc.ru/files/documentation/winmate/s430t2-nkc.pdf",
          "fileType": "pdf",
          "size": null,
          "sizeBytes": null
        }
      ]
    }
  ],
  "error": {},
  "message": ""
}