企业官网建设流程全解析

一、接口基础介绍

Ozon 是俄罗斯头部跨境电商平台，/v2/product/info/list是卖家侧标准商品详情批量查询接口，采用 POST 请求、Bearer Token 鉴权，支持批量传入product_id，一次性返回商品标题、价格、库存、类目、规格属性、图片视频、评分销量、活动优惠全套结构化数据。 配套补充接口/v3/products/info/attributes可获取完整商品参数，二者组合可拿到完整商品卡片数据，适用于跨境 ERP 同步、竞品价格监控、选品数据分析、多平台铺货素材采集等场景。鉴权方式：请求头携带Client-Id+Api-Key

二、核心业务应用场景

1. 跨境 ERP 商品同步：自动拉取 Ozon 商品价格、库存、图文，同步至自有进销存系统
2. 竞品价格监控：定时抓取同行售价、折扣活动，制定动态调价策略
3. 海外选品分析：统计类目商品销量、评分、用户评价，筛选潜力爆款
4. 多平台铺货素材采集：提取商品标题、描述、主图视频，快速制作独立站 / 速卖通素材
5. 店铺商品巡检：批量校验商品上架状态、库存余量、合规属性，及时下架缺货商品

三、标准成功返回 JSON（v2/product/info/list 完整版）

{ "result": [ { "product_id": 168954723, "offer_id": "EARPHONE-BLK-001", "product_status": "visible", "visibility": "VISIBLE", "name": "Беспроводные открытые наушники Bluetooth 5.3 черные", "short_description": "Легкие беспроводные наушники без закупорки уха, до 24 часов работы батареи", "description": "Открытые беспроводные наушники с Bluetooth 5.3, мягкая силиконовая подкладка, защита от пота IPX4, поддержка быстрой зарядки, стереозвук высокого качества.<br>Комплект: наушники, кейс зарядки, кабель Type-C.", "brand": "SoundAir", "category_id": 12845, "category_name": "Электроника > Аудио > Беспроводные наушники", "price": "2499.00", "old_price": "3299.00", "currency_code": "RUB", "visibility_price": "2499.00", "stock": { "present": 136, "reserved": 12, "total": 148 }, "images": [ "https://cdn.ozon.ru/product/168954723_main_1.jpg", "https://cdn.ozon.ru/product/168954723_detail_2.jpg", "https://cdn.ozon.ru/product/168954723_box_3.jpg" ], "videos": [ { "url": "https://video.ozon.ru/preview/168954723.mp4" } ], "rating": { "value": 4.7, "count": 216 }, "sales": { "sales_30d": 986, "sales_total": 4230 }, "attributes": [ { "id": 9632, "name": "Цвет", "value": "Черный", "type": "SELECT" }, { "id": 8741, "name": "Bluetooth версия", "value": "5.3", "type": "TEXT" }, { "id": 7532, "name": "Водозащита", "value": "IPX4", "type": "SELECT" } ], "dimensions": { "width": 82, "height": 45, "depth": 32, "weight": 28 } } ] }

四、高频异常返回 JSON 示例

1. 鉴权失败（Client-Id/Api-Key 错误）

{ "code": 401, "message": "Invalid Client-Id or Api-Key", "details": [] }

2. 请求限流超限

{ "code": 429, "message": "Request limit exceeded, retry after 60 seconds", "details": [] }

3. product_id 不存在 / 商品已归档

{ "result": [], "code": 0, "message": "success" }

4. 请求参数缺失

{ "code": 400, "message": "product_id array cannot be empty", "details": [] }

五、核心字段释义（精简版）

1. 商品基础标识

• product_id：Ozon 平台商品唯一 ID，查询主键
• offer_id：商家自定义货号，自有系统关联字段
• product_status/visibility：商品上架状态（VISIBLE 正常 / ARCHIVED 下架）
• name/short_description/description：商品标题、短卖点、长详情（俄语为主）

2. 价格与库存

• price：当前售价；old_price：原价（用于计算折扣）；currency_code货币单位 RUB 卢布
• stock.present：可售库存；reserved：已下单未发货占用库存

3. 素材媒体

• images：商品主图 / 详情图数组；videos商品宣传视频地址

4. 运营数据

• rating.value/count：商品平均评分、评价总数
• sales_30d近 30 天销量，sales_total 累计总销量

5. 属性规格

• attributes：材质、颜色、型号、防水等级等商品参数，用于筛选与详情展示

6. 物流包装

• dimensions商品长宽高 + 净重，用于头程物流核算

六、开发接入注意事项

1. Ozon 接口价格、库存字段均为字符串类型，金额计算需转换浮点；
2. result为空数组代表商品不存在 / 已归档，业务代码必须做空数组判断；
3. 批量查询单次最多传入 100 个product_id，高频采集需增加延时避免 429 限流；
4. 商品描述、属性默认俄语，无中文翻译字段，多语言站点需自行二次翻译；
5. 仅可用于合规店铺运营、数据分析，禁止批量爬取第三方店铺数据用于倒卖；
6. 完整规格参数需额外调用/v3/products/info/attributes接口补充获取。