产品系列
产品系列资源允许您检索 Lumytic 平台内的产品系列列表。 产品系列表示在某个系列和类别下更具体的产品分组。 此端点可以通过系列或类别进行筛选，仅显示相关的系列。
获取已发布的系列
检索所有已发布产品系列的列表。 此端点可用于在目录、仪表板或外部集成（例如外部网站）中显示系列。
端点：
GET
/product_development/v1/families?series_id={series_id}&category_id=4
Headers:* ApiKey: YOUR_API_KEY_HERE
- Content-Type: application/json
- Accept-Language: en
查询参数（可选）：
| 参数 | 类型 | 描述 | 示例 |
|---|---|---|---|
| series_id | 整数 | 按特定系列筛选产品系列。 | ../families?series_id=2 |
| category_id | 整数 | 按特定类别筛选产品系列。 | ../families?category_id=4 |
请求示例
curl -X GET "https://api.lumytic.com/product_development/v1/families?series_id=3" \
-H "ApiKey: YOUR_API_KEY_HERE" \
-H "Content-Type: application/json"
-H "Accept-Language: en"
响应示例
{
"success": true,
"message": "所有系列已成功获取。",
"data": {
"families": [
{
"ID": "78",
"series_name": "产品线 2",
"ProductID": "518",
"created_at": "2021-09-07 02:40:00",
"created_by": "Lillian.Ramirez",
"updated_at": "N/A",
"updated_by": "N/A",
"is_published": "0",
"series_id": "2",
"family_Name": "Muse",
"family_description": "<p>Muse 是一种电池供电的照明设备，当建筑物发生断电或照明电路故障时会自动开启。长寿命、免维护电池，应急时间超过 3 小时。墙壁和天花板均可表面安装和嵌入式安装。适用于具有 IP65 防护等级的潮湿场所。</p>\r\n",
"total_items": "1",
"category_names": "应急灯",
"category_ids": "38",
"datasheet_url" : "https://{domain_name}.lumytic.com/content/Product/product_datasheet_list/a%3A1%3A%7Bi%3A2%3Ba%3A1%3A%7Bi%3A0%3Bs%3A5%3A%2249450%22%3B%7D%7D/Muse",
"applications": [],
"installation_way": [
"表面式"
],
"family_photo": null,
"file_count": 0
},
{
"ID": "77",
"series_name": "产品线 2",
"ProductID": "507",
"created_at": "2021-06-15 03:00:00",
"created_by": "Brandon.James",
"updated_at": "2022-04-05 16:13:00",
"updated_by": "Brandon James",
"is_published": "1",
"series_id": "2",
"family_Name": "Day",
"family_description": "<p>Day 是一款非常好的多功能灯，可安装在墙壁或天花板上，具有非常强烈而清晰的照明效果，也具有耐候性，由特殊制造的 PC 材料制成，特别适合户外使用，具有三种功率选项和三种尺寸，UFO 必能满足您的照明设计，并将成为您户外墙壁或天花板的绝佳补充。</p>",
"total_items": "1",
"category_names": "舱壁灯",
"category_ids": "8",
"datasheet_url": "https:// {domain_name}.lumytic.com/content/Product/product_datasheet_list/a%3A1%3A%7Bi%3A2%3Ba%3A1%3A%7Bi%3A0%3Bs%3A5%3A%2249449%22%3B%7D%7D/Day",
"applications": [],
"installation_way": [
"表面式"
],
"family_photo": "https://{domain_name}.lumytic.com/tenants/{tenant_name} /files/Product/Economic/507/{image_name}.jpg",
"file_count": 2
},
]
}
}
可能出现的错误
| 代码 | 消息 | 描述 |
|---|---|---|
| 400 | 错误请求 | 提供了无效的查询参数 |
| 401 | 未经授权 | API 密钥缺失或无效。 |
| 404 | 未找到 | 未找到符合条件的系列。 |
| 500 | 内部服务器错误 | 服务器上发生意外错误。 |
GET 系列详情
此端点检索单个产品系列的详细信息。 当您需要显示或集成完整的系列信息，包括其属性、系列和类别时，此功能非常有用。
端点： GET /product_development/v1/families/{family_id}
路径参数：
- family_id (整数)：产品系列的唯一标识符
请求示例
curl -X GET "https://api.lumytic.com/product_development/v1/families/74" \
-H "ApiKey: YOUR_API_KEY_HERE" \
-H "Content-Type: application/json"
-H "Accept-Language: en"
响应示例
{
"success": true,
"message": "所有系列已成功获取。",
"data": {
"families": [
{
"ID": "74",
"series_name": "产品线 2",
"ProductID": "424",
"created_at": "2020-02-29 14:07:00",
"created_by": "May.Jones",
"updated_at": "2021-08-31 03:48:00",
"updated_by": "May Jones",
"series_id": "2",
"family_Name": "Vega",
"family_description": "设计现代典雅，流明可达 130LM/W，是一种经济高效的解决方案，具有全范围功率和可选光分布，从 30W 到 300W 全范围，高 IP67 等级保护，具有不同的光束角选项，可选非对称光分布。</li>\r\n\t<li>适用于多种应用，体育场、停车场、广告牌照明、港口和机场。</li>\r\n\t<li>不同光分布适用于各种应用，甚至包括体育场和广告牌。也可作为带滑套安装配件的路灯使用。",
"total_items": "3",
"category_names": "泛光灯",
"category_ids": "32",
"datasheet_url": "https://{domain_name}.lumytic.com /content/Product/product_datasheet_list/a%3A1%3A%7Bi%3A2%3Ba%3A3%3A%7Bi%3A0%3Bs%3A5%3A%2249438%22%3Bi%3A1%3Bs%3A5%3A%2249439%22%3Bi%3A2%3Bs%3A5%3A%2249440%22%3B%7D%7D/Vega",
"applications": [
"工厂",
"仓库",
"展览厅 ",
"体育馆"
],
"installation_way": [
"悬挂式",
"嵌入式",
"杆装式"
],
"family_photo": "https://{domain_name}.lumytic.com/tenants/{tenant_name} /files/Product/Economic/507/{image_name}.jpg",
"file_count": 2
}
]
}
}
系列可能出现的错误
| 代码 | 消息 | 描述 |
|---|---|---|
| 400 | 错误请求 | 提供了无效的查询参数 |
| 401 | 未经授权 | API 密钥缺失或无效。 |
| 404 | 未找到 | 未找到符合条件的系列。 |
| 500 | 内部服务器错误 | 服务器上发生意外错误。 |