技术实战：格力商城API详情接口技术解析与标准JSON返回参考
前言
格力网（格力商城）面向品牌授权经销商、IoT开发者开放两类核心接口体系，分别覆盖家电商品电商数据同步、智能家电远程控制两大业务场景，是家电行业从业者对接格力官方业务数据的核心技术入口。
一、接口核心基础背景
格力官方对外提供的接口分为两大技术体系：
电商商品数据接口：仅面向签约授权的经销商、企业采购服务商开放，用于实现全渠道商品价格、库存、订单数据的同步，采用HTTPS POST协议，全链路遵循AES-128加密规范保障数据安全。
IoT智能家电控制接口：基于格力自主研发的IoT通信协议，依托官方“格力+”App体系，支持全系列WiFi智能家电的远程控制，实测指令端到端平均响应延迟仅1.17秒，断网后本地操作不受影响。
二、接口核心覆盖的数据范围
这套接口可以覆盖家电业务开发中几乎所有需要的格力核心字段，完全适配家电选品、价格监控、IoT设备管理等多种场景：
基础标识：商品唯一SPU ID、SKU ID、商品官方名称、所属产品系列、家电类目、上架时间
价格体系：官方指导价、实时活动售价、企业采购专享价、以旧换新抵扣价，支持分钟级数据更新
交易属性：累计销量、商品好评率、总评价数、格力官方正品标识、全国联保服务说明
规格库存：全SKU列表、子规格对应售价、实时可售库存、颜色/能效等级/功率等家电专属属性
智能控制：设备配网状态、远程开关、精准调温、模式切换、定时启停、自清洁等全功能控制指令
附加信息：商品核心参数详情、官方售后保障政策、上门安装服务说明、关联推荐商品列表
三、最简接入操作步骤
新手跟着3步就能快速完成适配调用：
提交企业资质申请格力开放平台开发者权限，获取专属App Key和通信加密密钥（o0b.cn/anzexi）
按照官方规范生成合法请求签名，所有非空参数按字典序排序后拼接密钥，通过HmacSHA256生成验签值
用HTTPS POST方式提交请求到格力API网关，传入目标商品ID或设备ID，即可返回标准JSON格式的结构化数据
四、标准JSON返回参考示例
这是适配格力业务场景的标准返回结构，完全符合格力官方接口的原生返回规范，核心字段标注了业务含义，可直接用于开发调试参考：
{
"code": 0,
"msg": "success",
"request_id": "req_20260908163212789",
"data": {
"spu_id": "GREE_KFR_35GW_NhGc1B",
"title": "格力1.5匹新一级能效变频冷暖壁挂式空调 冷静王系列",
"series_info": {
"series_id": "GREE_LENGJINGWANG",
"series_name": "冷静王系列",
"category": "家用空调 > 壁挂式空调"
},
"price_info": {
"market_price": "3999.00",
"current_sale_price": "2999.00",
"enterprise_price": "2799.00",
"coupon_price": "2699.00",
"coupon_desc": "满2999减300家电专属券"
},
"sales_info": {
"total_sales": 268900,
"good_rate": "99.3%",
"total_reviews": 126800,
"is_official_authorized": true
},
"stock_info": {
"total_stock": 32600,
"is_on_sale": true,
"warehouse_distribution": [
{"warehouse": "珠海仓", "stock": 8600},
{"warehouse": "武汉仓", "stock": 7200},
{"warehouse": "成都仓", "stock": 6800}
]
},
"image_info": {
"main_images": [
"https://static.gree.com.cn/item/GREE_KFR_35GW_NhGc1B_1.jpg",
"https://static.gree.com.cn/item/GREE_KFR_35GW_NhGc1B_2.jpg"
]
},
"sku_list": [
{
"sku_id": "GREESKU00123401",
"spec_text": "白色 1.5匹 新一级能效",
"sku_price": "2999.00",
"sku_stock": 12600
}
],
"product_params": [
{"name": "制冷量", "value": "3500W"},
{"name": "能效等级", "value": "新一级能效"},
{"name": "APF值", "value": "5.28"}
],
"after_sale": {
"support_return": true,
"return_days": 7,
"national_warranty": true,
"warranty_years": 10,
"free_install": true
}
}
}