产品
产品资源允许您在 Lumytic 平台内检索和管理单个产品。产品是产品层次结构中最细粒度的项目，包含详细的属性、描述以及与其系列、类别和系列的关联关系。 产品是产品层级中最细粒度的项目，包含详细的属性、描述以及与其系列（Family）、类别（Category）和型号（Series）的关系。
获取已发布产品
检索特定产品系列内所有已发布的产品。 此端点适用于在产品目录、仪表板或外部集成中显示详细的产品信息。 它确保只返回标记为已发布的产品。
端点:
GET
/product_development/v1/products?product_family_id={product_family_id}
查询参数 (可选):
| 参数 | 类型 | 描述 | 示例 |
|---|---|---|---|
| product_family_id | integer | 按特定系列筛选产品。 | ../products?product_family_id=52 |
请求示例
curl -X GET "https://api.lumytic.com/product_development/v1/products?product_family_id=52“\
-H "ApiKey: YOUR_API_KEY_HERE" \
-H "Content-Type: application/json"
-H "Accept-Language: en"
响应示例
{
"success": true,
"message": "All collection fetched successfully.",
"data": {
"collection": [
{
"ID": "49440",
"weight": null,
"CRI": "70",
"Multiple_ip": "0",
"Front_ip": null,
"Back_ip": null,
"IP": "67",
"IK": "8",
"Power_up": "0",
"Power": "300",
"Current": null,
"frequency": null,
"Lumen": "41053",
"PowerFactor": null,
"warranty": "5",
"lifespan": "50000",
"reference_code": null,
"product_number": "P2-FDL-VEG300-04-025092",
"Firerated": "0",
"Firerated_value": null,
"labels": null,
"product_status": "Continued",
"barcode": null,
"zoomable": null,
"zoomable_value": null,
"Phases": null,
"Wires": null,
"Radius": "350",
"Length": null,
"Height": "100",
"Width": null,
"Family_name": "Vega",
"cat_name": "Floodlight",
"family_shortcut_code": "VE",
"description": "Vega - Floodlight <b style=\"font-weight: bold;\"></b> Recessed, Mounted on pole, Surface <b style=\"font-weight: bold;\">300 4000K</b> - 70 41053 - -IP 67 - <b style=\"font-weight: bold;\">Shanahan, Dare and Schulist LED </b><b style=\"font-weight: bold;\">Rectangular W372 x L481 x H71</b> BLACK / Die-cast aluminum (Housing) - <b style=\"font-weight: bold;\"
"photo_url": " https://{domain_name}.lumytic.com/tenants/{tenant_name} /files/Product/Economic/507/{image_name}.jpg ",
"datasheet_url": null,
"CCT_values": "4000",
"Beam_angle": "30 - 0",
"input_voltage": "-",
"WorkingTemperature": "-",
"qty_ctn": "12",
"ctn_size_cbm": "W39 x L51.5 x H35",
"ctn_volume": 0.0702975,
"symbol": "$",
"liminous_efficiency": "136.843lm/w",
"dimension": "Rectangular W372 x L481 x H71",
"cut_out": null,
"time_diff": "1321 days"
},
{
"ID": "49439",
"weight": null,
"CRI": "70",
"Multiple_ip": "0",
"Front_ip": null,
"Back_ip": null,
"IP": "67",
"IK": "8",
"Power_up": "0",
"Power": "240",
"Current": null,
"frequency": null,
"Lumen": "32842",
"PowerFactor": null,
"warranty": "5",
"lifespan": "50000",
"reference_code": null,
"product_number": "P2-FDL-VEG240-04-025075",
"Firerated": "0",
"Firerated_value": null,
"labels": null,
"product_status": "Continued",
"barcode": null,
"zoomable": null,
"zoomable_value": null,
"Phases": null,
"Wires": null,
"Radius": null,
"Length": "481",
"Height": "71",
"Width": "372",
"Family_name": "Vega",
"cat_name": "Floodlight",
"family_shortcut_code": "VE",
"supplier_name": "Wuckert PLC",
"supplier_id": "165",
"description": "Vega - Floodlight <b style=\"font-weight: bold;\"></b> Suspendant, Mounted on pole, Surface <b style=\"font-weight: bold;\">240 4000K</b> - 70 32842 - -IP 67 - <b style=\"font-weight: bold;\">Shanahan, Dare and Schulist LED </b><b style=\"font-weight: bold;\">Rectangular W372 x L481 x H71</b> BLACK / Die-cast aluminum (Housing) - <b style=\"font-weight: bold;\">5 </b><br/>",
"photo_url": " https://{domain_name}.lumytic.com/tenants/{tenant_name} /files/Product/Economic/507/{image_name}.jpg ",
"datasheet_url": null,
"CCT_values": "4000",
"Beam_angle": "90 - 120",
"input_voltage": "-",
"WorkingTemperature": "-",
"qty_ctn": "1",
"ctn_size_cbm": "W39.5 x L39.5 x H15",
"ctn_volume": 0.02340375,
"symbol": "$",
"liminous_efficiency": "136.8lm/w",
"dimension": "Rectangular W372 x L481 x H71",
"cut_out": null,
"time_diff": "1321 days"
} ],
"total_count": "2"
}
}
可能的错误
| 代码 | 消息 | 描述 |
|---|---|---|
| 400 | 错误请求 | 提供了无效的查询参数。 |
| 401 | 未授权 | API 密钥缺失或无效。 |
| 404 | 未找到 | 未找到具有指定 ID 的产品。 |
| 500 | 内部服务器错误 | 服务器发生意外错误。 |
获取产品详情
此端点检索单个产品的详细信息。当您需要显示或集成完整的产品信息（包括其属性）时，此功能非常有用。 当您需要显示或集成完整的产品信息，包括其属性时，它很有用。
端点 GET /product_development/v1/products/{product_id}
路径参数:
- Product_id (integer): 产品的唯一 ID。
请求示例
curl -X GET "https://api.lumytic.com/product_development/v1/products/520
-H "ApiKey: YOUR_API_KEY_HERE" \
-H "Content-Type: application/json
-H "Accept-Language: en"
响应示例
{
"success": true,
"message": "collection fetched successfully.",
"data": {
"ID": "49431",
"weight": null,
"CRI": "82",
"Multiple_ip": "0",
"Front_ip": null,
"Back_ip": null,
"IP": "67",
"IK": "8",
"Power_up": "0",
"Power": "10",
"Current": null,
"frequency": null,
"Lumen": "912",
"PowerFactor": null,
"warranty": "3",
"lifespan": "30000",
"reference_code": null,
"product_number": "P2-IN-AMB10-04-017916",
"Firerated": "0",
"Firerated_value": null,
"labels": null,
"product_status": "Continued",
"barcode": null,
"zoomable": null,
"zoomable_value": null,
"Phases": null,
"Wires": null,
"Radius": null,
"Length": "124",
"Height": "199",
"Width": "95",
"product_function": null,
"AdjustableType": "Not Adjustable",
"PowerType": "Dedicated driver",
"dc_voltage": null,
"manufacturing_technique": "CBU Completely Built Unit",
"Cut_out": "84",
"Family_name": "Ambi",
"cat_name": "Inground light ",
"productID": "273",
"CCT_values": "3000",
"description": "Ambi - Inground light <b style=\"font-weight: bold;\"></b> Recessed <b style=\"font-weight: bold;\">10 3000K</b> - 82 912 - -IP 67 - <b style=\"font-weight: bold;\">Lueilwitz PLC LED </b><b style=\"font-weight: bold;\">Square W95 x L95 x H135</b> 84 grey / Die-cast aluminum (Housing) - Grey Housing / Die-cast aluminum (Front Cover ) - transparent / Tempered glass (Front Cover ) - BLACK / plastic (Installation sleeve) - <b style=\"font-weight: bold;\">3 </b><br/>",
"Beam_angle": "23",
"input_voltage": "-",
"WorkingTemperature": "-",
"power": "10",
"qty_ctn": "5",
"ctn_size_cbm": "W16.5 x L63 x H67",
"ctn_volume": 0.0696465,
"symbol": "$",
"installation_way": [
"Recessed" ],
"fitting_shape": "Square",
"voltage_type": "",
"application": [
"Offices",
"Hospitals & Clinics",
"Supermarkets",
],
"category_name": "Inground light ",
"lighting_distributor": [
{
"kind": "Reflector ",
"color": "Silver ",
"material": "Plastic painted",
"Texture_photo": " https:// {domain_name}.lumytic.com/tenants/{tenant_name }/includes/upload_files/Texture/{image_name}.jpg ",
}
],
"datasheet_url": null,
"photo_url": " https://{domain_name}.lumytic.com/tenants/{tenant_name} /files/Product/Economic/273/{image_name}.jpg ",
"led_code": "temp005",
"driver_code": "temp006",
"certifications": "",
"solar_data": null,
"fitting_color": [
{
"part": "Housing",
"color": "grey",
"material": "Die-cast aluminum",
"Texture_photo": "https:// {domain_name}.lumytic.com/tenants/{tenant_name }/includes/upload_files/Texture/{image_name}.jpg"
},
{
"part": "Front Cover ",
"color": "Grey Housing",
"material": "Die-cast aluminum",
"Texture_photo": " https:// {domain_name}.lumytic.com/tenants/{tenant_name }/includes/upload_files/Texture/{image_name}.jpg "
},
],
"usd_price": 23.7,
"accessories": []
}
}
可能的错误
| 代码 | 消息 | 描述 |
|---|---|---|
| 400 | 错误请求 | 提供了无效的路径参数。 |
| 401 | 未授权 | API 密钥缺失或无效。 |
| 404 | 未找到 | 未找到具有指定 ID 的产品。 |
| 500 | 内部服务器错误 | 服务器发生意外错误。 |