SKU获取视频接口

提供查询多个SKU对应的视频资源的能力，支持根据指定时间范围筛选结果，返回视频链接及最新更新时间。

适用场景

获取SKU的相关视频资源，如产品展示视频、使用演示视频等

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/sku_video/query
测试环境：https://testing.westmonth.com/openapi/sku_video/query

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

参数名	类型	必填	格式示例	说明
skus	array	是	`["ROA10-A006-10-BU1", "ROA10-A006-10-PK1"]`	商品SKU列表，最多200个
start_time	string	否	`2024-12-17 18:24:47`	更新开始时间，格式为YYYY-MM-DD HH:MM:SS
end_time	string	否	`2026-12-17 18:24:47`	更新结束时间，格式同上

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0=成功，1=服务错误，2=参数错误，3=授权无效，4=请求上限）
msg	string	错误描述（成功时为空）
data	array	业务数据数组，每个元素对应一个SKU的视频信息

data数组字段

字段	类型	说明
sku	string	商品SKU
video	string	视频链接，指向该SKU对应的视频资源
latest_time	string	视频的最新更新时间，格式为YYYY-MM-DD HH:MM:SS

调用示例

URL请求

请求示例

{
    "skus": [
        "ROA10-A006-10-BU1",
        "ROA10-A006-10-PK1"
    ],
    "start_time": "2024-12-17 18:24:47",
    "end_time": ""
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "sku": "ROA10-A006-10-BU1",
            "video": "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-BU1/video/ROA10-A006-10-BU1-001.mp4",
            "latest_time": "2025-06-30 14:18:12"
        },
        {
            "sku": "ROA10-A006-10-PK1",
            "video": "https://oss.westmonth.com/westmonth/SKUDatum/old/ROA10-A006-10-PK1/video/ROA10-A006-10-PK1-001.mp4",
            "latest_time": "2025-07-07 16:19:45"
        }
    ]
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

常见问题

Q1：如果某个SKU没有对应的视频，会返回什么？

A：该SKU不会出现在data数组中，仅返回有视频资源且在指定时间范围内有更新的SKU数据。

Q2：视频链接支持哪些格式？

A：目前返回的视频链接以MP4格式为主，具体格式以实际链接为准，可直接用于播放或下载。

Q3：视频是否有时长或大小限制？

A：接口本身不限制视频的时长和大小，具体视频资源的属性由上传时的业务规则决定，可通过视频链接获取详细信息。

版本历史

版本	日期	修改说明
v1.0	2025-01-01	初始版本

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "sku": "ROA10-A006-10-BU1",
            "video": "https://westmonth/SKUDatum/old/ROA10-A006-10-BU1/video/ROA10-A006-10-BU1-001.mp4",
            "latest_time": "2024-12-24 16:13:28"
        },
        {
            "sku": "ROA10-A006-10-PK1",
            "video": "https://westmonth/SKUDatum/old/ROA10-A006-10-PK1/video/ROA10-A006-10-PK1-001.mp4",
            "latest_time": "2024-12-26 22:54:18"
        }
    ]
}

SKU视频

SKU获取视频接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：如果某个SKU没有对应的视频，会返回什么？#

Q2：视频链接支持哪些格式？#

Q3：视频是否有时长或大小限制？#

版本历史#

请求参数

请求示例代码

返回响应

SKU获取视频接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：如果某个SKU没有对应的视频，会返回什么？

Q2：视频链接支持哪些格式？

Q3：视频是否有时长或大小限制？

版本历史