首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >技术实战:格力商城API详情接口技术解析与标准JSON返回参考

技术实战:格力商城API详情接口技术解析与标准JSON返回参考

原创
作者头像
Anzexi58
发布2026-09-08 16:12:27
发布2026-09-08 16:12:27
230
举报
文章被收录于专栏:API接口开发API接口开发

前言

格力网(格力商城)面向品牌授权经销商、IoT开发者开放两类核心接口体系,分别覆盖家电商品电商数据同步、智能家电远程控制两大业务场景,是家电行业从业者对接格力官方业务数据的核心技术入口。

一、接口核心基础背景

格力官方对外提供的接口分为两大技术体系:

  1. 电商商品数据接口:仅面向签约授权的经销商、企业采购服务商开放,用于实现全渠道商品价格、库存、订单数据的同步,采用HTTPS POST协议,全链路遵循AES-128加密规范保障数据安全。
  2. IoT智能家电控制接口:基于格力自主研发的IoT通信协议,依托官方“格力+”App体系,支持全系列WiFi智能家电的远程控制,实测指令端到端平均响应延迟仅1.17秒,断网后本地操作不受影响。

二、接口核心覆盖的数据范围

这套接口可以覆盖家电业务开发中几乎所有需要的格力核心字段,完全适配家电选品、价格监控、IoT设备管理等多种场景:

  1. 基础标识:商品唯一SPU ID、SKU ID、商品官方名称、所属产品系列、家电类目、上架时间
  2. 价格体系:官方指导价、实时活动售价、企业采购专享价、以旧换新抵扣价,支持分钟级数据更新
  3. 交易属性:累计销量、商品好评率、总评价数、格力官方正品标识、全国联保服务说明
  4. 规格库存:全SKU列表、子规格对应售价、实时可售库存、颜色/能效等级/功率等家电专属属性
  5. 智能控制:设备配网状态、远程开关、精准调温、模式切换、定时启停、自清洁等全功能控制指令
  6. 附加信息:商品核心参数详情、官方售后保障政策、上门安装服务说明、关联推荐商品列表

三、最简接入操作步骤

新手跟着3步就能快速完成适配调用:

  1. 提交企业资质申请格力开放平台开发者权限,获取专属App Key和通信加密密钥(o0b.cn/anzexi)
  2. 按照官方规范生成合法请求签名,所有非空参数按字典序排序后拼接密钥,通过HmacSHA256生成验签值
  3. 用HTTPS POST方式提交请求到格力API网关,传入目标商品ID或设备ID,即可返回标准JSON格式的结构化数据

四、标准JSON返回参考示例

这是适配格力业务场景的标准返回结构,完全符合格力官方接口的原生返回规范,核心字段标注了业务含义,可直接用于开发调试参考:

代码语言:javascript
复制
{
  "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
    }
  }
}

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 前言
  • 一、接口核心基础背景
  • 二、接口核心覆盖的数据范围
  • 三、最简接入操作步骤
  • 四、标准JSON返回参考示例
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档