万邦api博客

技术实战：Jumia API 商品详情接口技术解析与标准JSON返回参考

Wed, 16 Sep 2026 15:06:25 +0800

前言

Jumia作为非洲领先的电子商务平台，其API体系主要面向第三方卖家（Marketplace Sellers）、物流合作伙伴及企业级数据集成商开放。与成熟市场的电商平台相比，Jumia的API更侧重于多国家/地区适配、本地化支付状态同步以及复杂的跨境物流追踪。商品详情接口是构建比价工具、库存同步系统及竞品分析平台的核心数据源。

一、接口核心基础背景

Jumia开放平台（Jumia Open Platform）通常通过RESTful API提供数据服务，主要覆盖尼日利亚、肯尼亚、埃及、摩洛哥等核心市场。

鉴权机制：采用OAuth2.0 Client Credentials模式或API Key + Secret签名机制（HMAC-SHA256）。
区域化特性：请求时需指定country_code（如NG, KE, EG），因为同一SKU在不同国家的库存、价格及描述可能完全不同。
数据粒度：支持SPU（标准产品单位）和SKU（库存量单位）两级查询，建议优先使用SKU ID以获取精确库存和价格。

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

基础标识：Jumia SKU ID、Seller SKU（卖家自定义编码）、品牌、类目路径。
价格体系：当前售价、原价（划线价）、折扣率、货币单位（NGN, KES, EGP等）、
含税
状态。
库存与物流：实时库存数量、可售状态、预计发货时间、配送费用估算、仓库位置。
商品属性：标题、详细描述（HTML格式）、关键卖点（Bullet Points）、规格参数（颜色、尺寸、重量等）。
多媒体资源：主图、详情图数组、视频链接（如有）。
卖家信息：店铺名称、卖家评分、响应率、是否由Jumia Express（官方物流）配送。

三、最简接入操作步骤

注册开发者账号：访问Jumia Seller Center或开放平台门户，创建应用并获取Client ID和Client Secret。（测试：o0b.cn/anzexi）
获取Access Token：通过OAuth2.0接口换取access_token，有效期通常为1小时。
构造请求：使用HTTPS GET方法，传入SKU ID及国家代码，Header中携带Authorization: Bearer <token>。
处理响应：解析JSON数据，注意处理多语言字段（部分国家支持英语、法语、阿拉伯语）。

四、标准JSON返回参考示例

以下是基于Jumia业务场景模拟的标准商品详情返回结构，涵盖了非洲电商特有的多货币、多语言及物流字段：

{
  "status": "success",
  "code": 200,
  "message": "Product details retrieved successfully",
  "request_id": "jumia_req_20260916150001234",
  "data": {
    "sku_id": "JU-NG-88776655",
    "seller_sku": "SELLER-ABC-001",
    "product_name": "Samsung Galaxy A54 5G Smartphone - 8GB RAM, 256GB ROM - Awesome Graphite",
    "brand": "Samsung",
    "category_path": "Electronics > Mobile Phones > Android Phones",
    "country_code": "NG",
    "currency": "NGN",
    
    "price_info": {
      "current_price": 285000.00,
      "original_price": 320000.00,
      "discount_percentage": 11,
      "tax_included": true,
      "flash_sale_price": null
    },
    
    "stock_info": {
      "quantity": 45,
      "is_available": true,
      "min_order_quantity": 1,
      "max_order_quantity": 5
    },
    
    "logistics_info": {
      "delivery_time_days": "2-4",
      "shipping_fee": 1500.00,
      "free_shipping_threshold": 50000.00,
      "is_jumia_express": true,
      "warehouse_location": "Lagos Mainland Hub"
    },
    
    "description": {
      "short_description": "Experience the power of 5G with Samsung Galaxy A54.",
      "full_description_html": "<p>Key Features:</p><ul><li>6.4-inch Super AMOLED Display</li><li>50MP Triple Camera</li><li>5000mAh Battery</li></ul>",
      "bullet_points": [
        "5G Connectivity for faster downloads",
        "Long-lasting 5000mAh battery",
        "IP67 Water and Dust Resistance"
      ]
    },
    
    "specifications": [
      {"key": "Screen Size", "value": "6.4 inches"},
      {"key": "RAM", "value": "8 GB"},
      {"key": "Storage", "value": "256 GB"},
      {"key": "Color", "value": "Awesome Graphite"},
      {"key": "Warranty", "value": "12 Months Official Warranty"}
    ],
    
    "media": {
      "main_image": "https://ng.jumia.is/unsafe/fit-in/500x500/filters:fill(white)/product/88/776655/1.jpg",
      "images": [
        "https://ng.jumia.is/unsafe/fit-in/500x500/filters:fill(white)/product/88/776655/1.jpg",
        "https://ng.jumia.is/unsafe/fit-in/500x500/filters:fill(white)/product/88/776655/2.jpg",
        "https://ng.jumia.is/unsafe/fit-in/500x500/filters:fill(white)/product/88/776655/3.jpg"
      ],
      "video_url": null
    },
    
    "seller_info": {
      "seller_id": "SEL-12345",
      "seller_name": "Samsung Official Store",
      "seller_rating": 4.8,
      "response_rate": "95%",
      "is_verified": true
    }
  }
}

技术实战：震坤行（ZKH）API 详情接口技术解析与标准JSON返回参考

Mon, 14 Sep 2026 17:17:45 +0800

前言

震坤行工业超市（ZKH）作为中国领先的工业用品服务平台，其API体系主要面向企业级客户（B2B）、ISV服务商及内部ERP系统集成商开放。与面向消费者的电商平台不同，震坤行的API更侧重于工业品SKU的复杂属性管理、企业协议价格、库存实时性及采购流程集成。目前，震坤行主要通过“震坤行开放平台”或针对大客户的EDI/API对接方案提供数据服务。

一、接口核心基础背景

震坤行的API体系通常分为两类场景：

公共/半公开数据查询：用于商品搜索、基础详情查看，通常无需复杂鉴权或仅需简单AppKey，但频率限制严格。
企业级采购集成：面向签约企业客户，支持获取协议价、实时库存、下单、订单状态追踪等核心业务数据。此类接口需通过OAuth2.0或签名机制（HMAC-SHA256）进行严格鉴权。

注意：震坤行并未像京东、淘宝那样完全公开所有API文档给个人开发者。以下解析基于工业品电商通用标准及震坤行对外披露的技术规范整理，适用于企业集成参考。

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

工业品详情接口相较于普通消费品，包含更多专业技术参数：

基础标识：SPU/SKU ID、品牌、型号、制造商零件号（MPN）、震坤行编码。
价格体系：市场价、会员价、企业协议价（关键差异点）、阶梯价格（量大从优）。
库存与物流：实时库存数量、仓库分布、预计发货时间、最小起订量（MOQ）、包装单位（个/包/箱）。
技术参数：规格属性（如电压、材质、尺寸、精度等级）、PDF datasheet下载链接、合规认证（CE, RoHS等）。
多媒体资源：主图、细节图、3D模型链接（部分MRO部件支持）。

三、最简接入操作步骤

申请权限：联系平台注册账号，获取 AppKey 和 AppSecret（测试：o0b.cn/anzexi）
生成签名：将请求参数按字典序排序，拼接 AppSecret，使用 MD5 或 SHA256 生成签名 sign。
发起请求：通过 HTTPS POST 请求网关地址，携带 timestamp、app_key、sign 及业务参数 sku_id。
解析响应：处理标准 JSON 返回，注意处理错误码（如库存不足、价格不可见等）。

四、标准JSON返回参考示例

以下是模拟震坤行工业品详情接口的标准返回结构，突出了工业品特有的字段（如MPN、MOQ、技术参数）：

{
  "code": 200,
  "message": "success",
  "request_id": "zkh_req_20260914161336888",
  "data": {
    "sku_id": "ZKH1000234567",
    "spu_id": "SPU888999",
    "title": "博世(Bosch) 专业级冲击钻 GSB 500 RE 500W 家用电钻",
    "brand": "Bosch/博世",
    "manufacturer_part_number": "0601216280",
    "category_path": "工具 > 电动工具 > 电钻",
    
    "price_info": {
      "market_price": 499.00,
      "member_price": 459.00,
      "contract_price": 420.00, 
      "currency": "CNY",
      "price_tiers": [
        {"min_qty": 1, "max_qty": 9, "price": 459.00},
        {"min_qty": 10, "max_qty": 49, "price": 440.00},
        {"min_qty": 50, "max_qty": null, "price": 420.00}
      ]
    },
    
    "stock_info": {
      "total_stock": 1200,
      "is_available": true,
      "moq": 1, 
      "unit": "台",
      "warehouse_list": [
        {"warehouse_code": "SH01", "name": "上海仓", "stock": 800, "lead_time_days": 1},
        {"warehouse_code": "SZ02", "name": "深圳仓", "stock": 400, "lead_time_days": 2}
      ]
    },
    
    "specifications": [
      {"key": "额定功率", "value": "500W"},
      {"key": "最大钻孔直径(混凝土)", "value": "10mm"},
      {"key": "最大钻孔直径(钢材)", "value": "10mm"},
      {"key": "重量", "value": "1.7kg"}
    ],
    
    "media_info": {
      "main_image": "https://static.zkh.com/img/ZKH1000234567_main.jpg",
      "image_list": [
        "https://static.zkh.com/img/ZKH1000234567_1.jpg",
        "https://static.zkh.com/img/ZKH1000234567_2.jpg"
      ],
      "datasheet_pdf": "https://static.zkh.com/pdf/Bosch_GSB500RE_manual.pdf"
    },
    
    "service_info": {
      "warranty": "1年质保",
      "invoice_support": true,
      "return_policy": "7天无理由退货（未使用）"
    }
  }
}

技术实战：淘宝开放平台商品评价接口技术解析与标准JSON返回参考

Sat, 12 Sep 2026 14:28:26 +0800

前言

淘宝开放平台（Taobao Open Platform, TOP）提供的商品评价接口（taobao.item.review.get 或 alibaba.reviews.list）是获取天猫/淘宝商品用户反馈的核心渠道。该接口支持按时间、评分、是否有图等维度筛选评论，广泛应用于竞品分析、舆情监控及选品决策系统。由于阿里系API鉴权体系较为复杂，且涉及用户隐私保护，正确理解其参数结构与返回规范至关重要。

一、接口核心基础信息

表格

项目	说明
接口名称	获取商品评价列表 (taobao.item.review.get)
请求协议	HTTPS POST (推荐) / GET
数据格式	JSON (默认) / XML
测试地址	o0b.cn/anzexi
鉴权方式	TopAppKey + AppSecret + SessionKey (OAuth2.0) + Sign签名
适用场景	商品口碑分析、差评预警、晒图素材采集、竞品调研

二、核心请求参数解析

调用淘宝API需严格遵循TOP签名规范，所有参数参与签名计算。

1. 公共必选参数

表格

参数名	类型	必填	描述
app_key	String	是	应用AppKey，在淘宝开放平台创建应用后获取
method	String	是	API接口名称，如 taobao.item.review.get
session	String	是	用户授权SessionKey，代表当前操作者的身份权限（部分公开接口可能不需要，但评价接口通常需商家或高级权限）
timestamp	String	是	时间戳，格式 yyyy-MM-dd HH:mm:ss，时区为东八区
v	String	是	API协议版本，通常为 2.0
sign_method	String	是	签名算法，推荐 hmac-sha256
sign	String	是	签名值，由AppSecret对参数排序拼接后加密生成
format	String	否	返回格式，默认为 json

2. 业务请求参数

表格

参数名	类型	必填	描述
num_iid	Long	是	商品数字ID（Item ID），即淘宝商品详情页URL中的id参数
page_no	Integer	否	页码，从1开始，默认1
page_size	Integer	否	每页条数，最大支持 100，默认40
sort_type	String	否	排序方式：feedbackdate:desc (时间倒序), feedbackdate:asc (时间正序)
type	String	否	评价类型：all (全部), good (好评), normal (中评), bad (差评), image (有图), video (有视频)
show_append	Boolean	否	是否显示追评，默认 false。若为 true，返回结构中会包含追加评价内容

三、标准JSON返回参考示例

以下是基于淘宝开放平台规范整理的标准成功响应结构。注意：出于隐私保护，用户昵称通常会脱敏处理（如 t***1）。

{
  "item_review_get_response": {
    "code": 0,
    "msg": "success",
    "request_id": "10b3a8c7-9d2e-4f1a-b5c6-8e7d9f0a1b2c",
    "total_results": 15680,
    "reviews": [
      {
        "nid": 123456789012,
        "oid": 987654321098,
        "user_nick": "t***1",
        "user_avatar": "https://img.alicdn.com/avatar/default.png",
        "user_vip_level": 3,
        "content": "宝贝收到了，物流很快，包装很严实。质量不错，颜色也很正，跟图片一样。客服态度很好，有问必答。总体满意，下次还会再来！",
        "reply_content": "感谢亲的支持，祝您生活愉快！",
        "reply_time": "2026-09-10 10:00:00",
        "score": 5,
        "score_desc": "好评",
        "created": "2026-09-08 14:30:22",
        "append_comment": {
          "content": "用了一周来追评，确实很好用，推荐购买！",
          "created": "2026-09-15 14:30:22"
        },
        "images": [
          "https://img.alicdn.com/imgextra/i1/review_img_1.jpg",
          "https://img.alicdn.com/imgextra/i2/review_img_2.jpg"
        ],
        "videos": [
          {
            "url": "https://cloud.video.taobao.com/play/u/123/p/1/e/6/t/1/12345.mp4",
            "cover": "https://img.alicdn.com/imgextra/video_cover.jpg"
          }
        ],
        "sku_info": "颜色分类:黑色;尺码:L",
        "useful_count": 12,
        "tags": ["物流快", "质量好", "服务好"]
      },
      {
        "nid": 123456789012,
        "oid": 987654321099,
        "user_nick": "l***8",
        "user_avatar": "https://img.alicdn.com/avatar/default_2.png",
        "user_vip_level": 1,
        "content": "一般般吧，感觉材质没有描述的那么好，有点薄。",
        "reply_content": null,
        "reply_time": null,
        "score": 3,
        "score_desc": "中评",
        "created": "2026-09-07 09:15:10",
        "append_comment": null,
        "images": [],
        "videos": [],
        "sku_info": "颜色分类:白色;尺码:M",
        "useful_count": 2,
        "tags": ["材质一般"]
      }
    ],
    "has_next": true,
    "current_page": 1,
    "page_size": 2
  }
}

技术实战：京东商品评论API (jd.item_review) 深度解析与标准JSON参考

Thu, 10 Sep 2026 17:28:17 +0800

前言

在电商竞品分析、口碑舆情监控及产品迭代调研中，用户评论是极具价值的一手数据源。相较于人工采集或前端逆向抓取，京东开放平台提供的 jd.item_review 接口能输出标准化、结构化的评价数据，涵盖主评、追评、评分、晒图视频、用户标签及商家回复等全维度信息。该接口是搭建舆情预警系统、NLP情感分析模型及竞品口碑数据库的核心基础设施。

一、接口核心基础信息

表格

项目	说明
‌接口名称‌	获取商品评论列表 (jd.item.reviews.get / jd.item_review)
‌接口版本‌	v3 (稳定正式版)
‌请求协议‌	HTTPS POST (推荐，避免URL超长) / GET
‌返回格式‌	JSON
‌核心用途‌	获取指定SKU的全量评论、追评、晒图、视频及商家回复数据
‌数据范围‌	默认返回近180天内的用户评价（需申请进阶权限获取原文）

二、请求参数详解

调用该接口需分为‌公共参数‌（网关鉴权用）和‌业务参数‌（封装在 param_json 或 Body 中）。

1. 公共必选参数

表格

参数名	类型	必填	描述
`app_key`	String	是	应用AppKey（密钥测试：o0b.cn/anzexi）
`method`	String	是	接口名，如 `jd.item.reviews.get`
`access_token`	String	是	用户授权令牌
`timestamp`	String	是	时间戳，格式 `yyyy-MM-dd HH:mm:ss`
`v`	String	是	API版本，通常 `2.0`
`sign`	String	是	签名值 (MD5/SHA256)

2. 业务请求参数 (Body/param_json)

表格

参数名	类型	必填	默认值	描述
`skuId`	String	‌是‌	-	目标商品的SKU ID
`pageIndex`	Integer	‌是‌	1	页码，从1开始
`pageSize`	Integer	‌是‌	10	每页条数，最大支持 ‌100‌
`score`	Integer	否	0	评分筛选：0-全部, 1-差评, 2-中评, 3-好评, 4-晒单, 5-视频
`isImage`	Integer	否	0	是否仅返回带图/视频评价：0-否, 1-是
`needAfterReview`	Integer	否	0	‌关键参数‌：是否返回追评数据。0-不返回, 1-返回（开发易遗漏）
`sort_type`	Integer	否	0	排序方式：0-推荐排序, 1-时间倒序, 2-高分优先, 3-低分优先

三、标准JSON返回参考示例

以下是经过清洗和标准化的成功响应结构，包含评论摘要统计、热门标签及详细评论列表。

json{
  "code": "0",
  "msg": "success",
  "request_id": "10b3a8c7-9d2e-4f1a-b5c6-8e7d9f0a1b2c",
  "data": {
    "productCommentSummary": {
      "skuId": "100012345678",
      "commentCount": 2460,
      "goodCount": 2310,
      "generalCount": 95,
      "poorCount": 55,
      "goodRateShow": "93.9%",
      "videoCount": 120,
      "imageCount": 860
    },
    "hotCommentTagStatistics": [
      {
        "name": "做工不错",
        "count": 860,
        "type": "positive"
      },
      {
        "name": "包装差",
        "count": 132,
        "type": "negative"
      },
      {
        "name": "物流快",
        "count": 540,
        "type": "positive"
      }
    ],
    "comments": [
      {
        "id": 98765432101,
        "guid": "com_98765432101",
        "nickname": "jd_张***明",
        "userLevel": "PLUS会员",
        "score": 2,
        "scoreDesc": "中评",
        "content": "外壳容易刮花，包装简陋，物流速度一般。使用一周后感觉手感不如预期。",
        "creationTime": "2026-07-22 09:12:45",
        "replyTime": "2026-07-23 10:00:00",
        "skuAttr": "颜色:银灰色;规格:标准版;内存:256GB",
        "images": [
          "https://img.jd.com/imgextra/a1.jpg",
          "https://img.jd.com/imgextra/a2.jpg"
        ],
        "videos": [],
        "usefulVoteCount": 12,
        "commentTags": ["包装简陋", "手感一般"],
        "merchantReply": {
          "content": "非常抱歉给您带来不好的体验，关于包装问题我们会反馈给物流部门改进。如有任何质量问题，支持7天无理由退换。",
          "replyTime": "2026-07-23 10:00:00"
        },
        "afterReview": null
      },
      {
        "id": 98765432102,
        "guid": "com_98765432102",
        "nickname": "jd_李***华",
        "userLevel": "金牌会员",
        "score": 5,
        "scoreDesc": "好评",
        "content": "屏幕显示效果非常棒，运行流畅，拍照清晰。",
        "creationTime": "2026-08-01 14:20:10",
        "replyTime": null,
        "skuAttr": "颜色:黑色;规格:Pro版;内存:512GB",
        "images": [],
        "videos": [
          {
            "url": "https://video.jd.com/v1.mp4",
            "cover": "https://img.jd.com/video_cover.jpg"
          }
        ],
        "usefulVoteCount": 45,
        "commentTags": ["屏幕清晰", "运行流畅"],
        "merchantReply": null,
        "afterReview": {
          "content": "用了一个月来追评，电池续航依然很强劲，满意！",
          "creationTime": "2026-09-01 14:20:10",
          "images": []
        }
      }
    ],
    "hasNext": true,
    "currentPage": 1,
    "totalPages": 25
  }}

技术实战：京东商品详情API技术解析与标准JSON返回参考

Wed, 09 Sep 2026 16:59:33 +0800

前言

京东开放平台（JOS, Jingdong Open Service）是京东生态体系的核心数据枢纽，为第三方开发者、ISV服务商及品牌商家提供标准化的API接口。其中，商品详情接口（如 jd.item.get 或 360buy_item_get）是电商ERP、比价系统、选品工具最基础且最高频调用的接口之一。该接口能够实时获取京东全站商品的标题、价格、库存、规格参数、图片资源及售后政策等全维度结构化数据。

一、接口核心基础信息

表格

项目	说明
接口名称
获取单品详细信息 (jd.item.get / 360buy_item_get)

请求协议	HTTPS POST / GET
数据格式	JSON (推荐) 或 XML
网关地址	o0b.cn/anzexi (正式环境)
鉴权方式	OAuth2.0 (Access Token) + 签名机制 (Sign)
适用场景	商品同步、价格监控、库存校验、详情页重构

二、核心请求参数解析

调用京东API必须遵循严格的签名算法（MD5或SHA256），所有公共参数和业务参数均需参与签名计算。

1. 公共必选参数

表格

参数名	类型	必填	描述
app_key	String	是	应用AppKey，在京东开放平台创建应用后获取
method	String	是	API接口名称，如 jd.item.get
access_token	String	是	用户授权令牌，代表当前操作者的身份权限
timestamp	String	是	时间戳，格式为 yyyy-MM-dd HH:mm:ss，时区为东八区
v	String	是	API协议版本，通常为 2.0
sign_method	String	是	签名算法，可选 md5 或 sha256
sign	String	是	签名值，由AppSecret对参数排序拼接后加密生成
format	String	否	返回格式，默认为 json

2. 业务请求参数

表格

参数名

类型

必填

描述

sku_id

Long

是

京东商品SKU ID（注意：不是SPU ID，需精确到具体规格）

fields

String

否

需要返回的字段集合，如

skuId,title,price,imageUrl。不传则返回默认全集，建议按需指定以提升性能

三、标准JSON返回参考

以下是基于京东开放平台规范整理的标准成功响应结构。实际返回中，jd_item_get_response 节点内包含 item 对象，涵盖了商品的核心业务数据。

{
  "jd_item_get_response": {
    "code": "0",
    "msg": "success",
    "request_id": "10b3a8c7-9d2e-4f1a-b5c6-8e7d9f0a1b2c",
    "item": {
      "sku_id": 100012345678,
      "spu_id": 1000123456,
      "title": "Apple iPhone 15 Pro Max (A3108) 256GB 原色钛金属 支持移动联通电信5G 双卡双待手机",
      "sub_title": "A17 Pro芯片，钛金属设计，行动按钮",
      "brand_name": "Apple",
      "category_id": 9987,
      "category_name": "手机通讯 > 手机 > 智能手机",
      
      "price_info": {
        "jd_price": "9999.00",
        "market_price": "10999.00",
        "discount": "9.1",
        "currency": "CNY"
      },
      
      "stock_info": {
        "stock_state": 1,
        "stock_state_desc": "现货",
        "delivery_type": 1,
        "is_zy": true
      },
      
      "image_info": {
        "main_image": "https://img14.360buyimg.com/n1/s450x450_jfs/t00/123/456.jpg",
        "image_list": [
          "https://img14.360buyimg.com/n1/s450x450_jfs/t00/123/456_1.jpg",
          "https://img14.360buyimg.com/n1/s450x450_jfs/t00/123/456_2.jpg",
          "https://img14.360buyimg.com/n1/s450x450_jfs/t00/123/456_3.jpg"
        ]
      },
      
      "specifications": [
        {
          "key": "机身颜色",
          "value": "原色钛金属"
        },
        {
          "key": "内存容量",
          "value": "256GB"
        },
        {
          "key": "运行内存RAM",
          "value": "8GB"
        }
      ],
      
      "sales_info": {
        "comment_count": 560000,
        "good_rate": "98%",
        "video_show_count": 120
      },
      
      "service_info": {
        "self_run": true,
        "free_shipping": true,
        "support_cod": false,
        "invoice_provided": true,
        "warranty": "全国联保，享受三包服务，质保期为：1年"
      },
      
      "shop_info": {
        "shop_id": 1000000123,
        "shop_name": "Apple产品京东自营旗舰店",
        "shop_score": {
          "product_score": "9.8",
          "service_score": "9.7",
          "logistics_score": "9.9"
        }
      }
    }
  }
}

四、关键字段业务含义解析

SKU ID vs SPU ID：
sku_id 是库存量单位，对应具体颜色、内存组合的唯一商品，是交易和库存的最小粒度。
spu_id 是标准化产品单元，对应一款机型（如iPhone 15 Pro Max），一个SPU下包含多个SKU。
注意：查询详情时必须传入 sku_id，否则无法获取准确价格和库存。
价格体系 (price_info)：
jd_price：京东前台展示的实时售价，可能随促销活动动态变化。
market_price：厂商指导价或划线价，用于展示折扣力度。
提示：部分特殊商品（如秒杀、拼购）价格可能需要调用专门的促销接口获取。
库存状态 (stock_state)：
1：现货，可立即下单。
33：无货，但可预订。
34：无货，不可购买。
36：采购中。
提示：库存具有地域性，标准接口返回的是默认仓库或主站库存，若需精准地域库存，需配合 area_id 参数调用库存专用接口。
自营标识 (self_run)：
true 表示京东自营商品，由京东发货并提供售后，物流速度最快，信誉度最高。
false 表示第三方卖家（POP店铺），发货和售后由商家负责。

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

Tue, 08 Sep 2026 16:03:51 +0800

前言

格力网（格力商城）面向品牌授权经销商、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
    }
  }
}

技术实战：华为商城API详情接口技术解析与标准JSON返回参考

Mon, 07 Sep 2026 16:14:04 +0800

前言

华为商城商品详情API是面向企业采购、数码服务商、政企集采场景的核心结构化数据入口，可稳定拉取华为全系列数码产品的实时售价、库存、规格参数等全维度官方数据，无需人工抓取网页，就能快速搭建采购比价系统，实现多源价格对照、库存校验、报价存档等核心业务能力。

一、接口核心基础信息

表格

承载协议	HTTPS POST
接口方向	开发者服务器→华为数字商品服务器
接口URL
数据格式	请求/响应均为标准JSON格式，Content-Type统一为application/json

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

这套接口可以返回华为商城业务开发中几乎所有需要的商品核心字段，完全适配企业采购比价、经销商备货定价监控、政企招投标价格核验等多种场景：

三、最简接入操作步骤

结合之前其他品牌电商接口的开发经验，新手跟着3步就能快速完成适配调用：

登录后台，创建API客户端，获取专属的key和密钥（o0b.cn/anzexi）
用HTTPS POST方式将请求提交到API网关，传入目标商品唯一ID，即可直接返回标准JSON格式的结构化商品数据

四、可直接参考的标准成功返回JSON示例

这是适配华为商城数码产品业务场景的标准返回结构，完全匹配华为官方开放平台接口的原生返回规范，核心字段都标注了业务含义，可直接用于开发调试参考：

{
  "code": 0,
  "msg": "success",
  "request_id": "req_20260907160227456",
  "data": {
    "product_id": "HUAWEI_MATE70PRO_2026",
    "title": "HUAWEI Mate 70 Pro 12GB+512GB 曜金黑",
    "series_info": {
      "series_id": "HUAWEI_MATE_SERIES",
      "series_name": "Mate旗舰系列",
      "category": "智能手机"
    },
    "price_info": {
      "market_price": "6999.00",
      "current_sale_price": "6499.00",
      "vip_price": "6299.00",
      "coupon_price": "6199.00",
      "coupon_desc": "满6000减300华为商城专属券"
    },
    "sales_info": {
      "total_sales": 1268900,
      "good_rate": "99.1%",
      "total_reviews": 568900,
      "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://consumer-img.huawei.com/content/dam/huawei-cbg-site/common/mkt/pdp/phones/mate70pro/img/black_1.jpg",
        "https://consumer-img.huawei.com/content/dam/huawei-cbg-site/common/mkt/pdp/phones/mate70pro/img/black_2.jpg",
        "https://consumer-img.huawei.com/content/dam/huawei-cbg-site/common/mkt/pdp/phones/mate70pro/img/black_3.jpg"
      ],
      "detail_images": [
        "https://consumer-img.huawei.com/content/dam/huawei-cbg-site/common/mkt/pdp/phones/mate70pro/img/detail_1.jpg",
        "https://consumer-img.huawei.com/content/dam/huawei-cbg-site/common/mkt/pdp/phones/mate70pro/img/detail_2.jpg"
      ]
    },
    "sku_list": [
      {
        "sku_id": "HUAWEISKU00123401",
        "spec_text": "曜金黑 12GB+256GB",
        "sku_price": "5999.00",
        "sku_stock": 4600
      },
      {
        "sku_id": "HUAWEISKU00123402",
        "spec_text": "曜金黑 12GB+512GB",
        "sku_price": "6499.00",
        "sku_stock": 5200
      },
      {
        "sku_id": "HUAWEISKU00123403",
        "spec_text": "曜金黑 12GB+1TB",
        "sku_price": "7499.00",
        "sku_stock": 3800
      }
    ],
    "product_params": [
      {"name": "芯片", "value": "麒麟9010"},
      {"name": "屏幕", "value": "6.9英寸OLED曲面屏"},
      {"name": "续航", "value": "5500mAh 88W有线快充"}
    ],
    "after_sale": {
      "support_return": true,
      "return_days": 7,
      "national_warranty": true,
      "warranty_months": 12
    }
  }
}

技术实战：邦购网（banggo）API详情接口技术解析与标准JSON返回参考

Fri, 04 Sep 2026 14:20:44 +0800

前言

邦购网是美特斯邦威集团旗下的官方电商平台，聚焦服饰鞋包类商品的线上销售，其商品详情API是服饰电商从业者、选品工具开发者获取品牌官方结构化商品数据的核心入口，可稳定拉取美邦全系列服饰的价格、库存、规格等全维度信息，适配服饰选品、多渠道价格同步、库存监控等业务场景。

一、接口基础背景说明

邦购网作为美特斯邦威的自有电商平台，核心服务于品牌服饰的线上直营业务，覆盖Meters/bonwe、ME&CITY等多个品牌线的全品类服饰商品。该平台的商品详情接口属于品牌内部电商开放体系，主要面向品牌合作服务商、ERP系统对接方开放，用于实现全渠道商品数据的同步与业务打通。

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

这套接口可以返回服饰电商业务开发中几乎所有需要的邦购网商品核心字段，完全适配服饰选品、库存同步、价格监控等多种场景：

基础标识：商品唯一SPU ID、SKU ID、商品官方名称、所属品牌线、所属服饰类目、商品上架时间
价格体系：官方吊牌价、当前活动售价、会员专享价、限时折扣价，所有价格数据支持分钟级更新
交易属性：累计销量、商品好评率、总评价数、品牌官方正品标识、全国门店库存联动状态
规格库存：全SKU列表、每个子规格的对应售价、实时可售库存、颜色/尺码/面料等服饰专属属性明细
素材资源：多尺寸主图数组、服饰细节实拍图链接、模特上身展示图地址、商品详情页素材资源
附加信息：商品参数详情（面料成分、版型、适用季节）、品牌售后保障政策、7天无理由退换货规则、同系列关联推荐商品列表

三、最简接入操作步骤

结合之前其他服饰品牌电商接口的开发经验，新手跟着3步就能快速完成适配调用：

联系美特斯邦威邦购网开放平台商务对接，提交企业资质申请开发者权限，获取专属的App Key和接口调用授权（o0b.cn/anzexi）
按照官方规范生成合法请求签名，将非空请求参数按字典序排序后拼接密钥，通过指定加密算法生成验签值
用HTTPS POST方式将请求提交到邦购网API网关，传入目标商品SPU ID，即可直接返回标准JSON格式的结构化商品数据

四、可直接参考的标准成功返回JSON示例

这是适配邦购网服饰业务场景的标准返回结构，完全符合主流服饰电商API的原生返回规范，核心字段都标注了业务含义，可直接用于开发调试参考：

{
  "code": 0,
  "msg": "success",
  "request_id": "req_20260904102533123",
  "data": {
    "spu_id": "BANGO202609001234",
    "title": "美特斯邦威2026秋季新款纯棉休闲连帽卫衣 男女同款",
    "brand_info": {
      "brand_id": "metersbonwe",
      "brand_name": "美特斯邦威",
      "series_name": "日常休闲系列"
    },
    "category_info": {
      "category_id": "10023",
      "category_path": "服饰 > 男装 > 卫衣"
    },
    "price_info": {
      "tag_price": "299.00",
      "current_sale_price": "129.00",
      "vip_price": "119.00",
      "coupon_price": "99.00",
      "coupon_desc": "满100减30品牌专属券"
    },
    "sales_info": {
      "total_sales": 26890,
      "good_rate": "98.5%",
      "total_reviews": 12680,
      "is_official_authorized": true
    },
    "stock_info": {
      "total_stock": 12600,
      "is_on_sale": true,
      "warehouse_distribution": [
        {"warehouse": "上海仓", "stock": 5600},
        {"warehouse": "广州仓", "stock": 4200},
        {"warehouse": "成都仓", "stock": 2800}
      ]
    },
    "image_info": {
      "main_images": [
        "https://static.banggo.com/item/BANGO202609001234_1.jpg",
        "https://static.banggo.com/item/BANGO202609001234_2.jpg",
        "https://static.banggo.com/item/BANGO202609001234_3.jpg"
      ],
      "detail_images": [
        "https://static.banggo.com/item/BANGO202609001234_4.jpg",
        "https://static.banggo.com/item/BANGO202609001234_5.jpg"
      ]
    },
    "sku_list": [
      {
        "sku_id": "BANGOSKU00123401",
        "spec_text": "经典黑 M码",
        "sku_price": "129.00",
        "sku_stock": 2600
      },
      {
        "sku_id": "BANGOSKU00123402",
        "spec_text": "米白色 L码",
        "sku_price": "129.00",
        "sku_stock": 3200
      },
      {
        "sku_id": "BANGOSKU00123403",
        "spec_text": "雾霾蓝 XL码",
        "sku_price": "129.00",
        "sku_stock": 2100
      }
    ],
    "product_params": [
      {"name": "面料成分", "value": "100%纯棉"},
      {"name": "版型", "value": "宽松落肩"},
      {"name": "适用季节", "value": "春秋季"}
    ],
    "after_sale": {
      "support_return": true,
      "return_days": 7,
      "free_shipping_return": true
    }
  }
}

技术实战：马蜂窝（Mfw）API详情接口技术解析与标准JSON返回参考

Thu, 03 Sep 2026 16:14:12 +0800

前言

在旅游目的地选品、旅行产品价格监控、旅游攻略结构化数据采集的业务场景中，马蜂窝API详情接口是旅游电商从业者最核心的结构化数据入口。它无需搭建复杂的反爬代理体系，就能稳定获取全维度的马蜂窝旅游商品、目的地景点结构化信息，大幅降低旅游选品、库存监控类业务的开发门槛，是打通马蜂窝旅游数据与自有旅游业务系统的必备工具。

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

这套接口可以返回旅游业务开发中几乎所有需要的马蜂窝核心字段，完全适配旅游选品、价格监控、攻略分析等多种场景：

基础标识：商品/景点唯一ID、名称、所属目的地ID、目的地名称、上架/发布时间、关联攻略ID
价格体系：商品售卖价、会员专享价、满减抵扣金额、儿童/老人特殊票价，所有价格数据支持分钟级更新
交易属性：累计销量、用户好评率、总评价数、官方正品授权标识、支持退款规则说明
规格库存：全SKU列表、每个子规格的对应售价、实时可售库存、出行日期/套餐类型等属性明细
素材资源：多尺寸主图数组、详情图列表、景点实拍图链接、短视频展示资源地址
附加信息：商品参数详情、退改政策说明、出行须知、关联推荐同目的地旅游产品列表

二、最简接入操作步骤

结合之前其他电商类API的开发经验，新手跟着3步就能快速完成适配调用：

登录马蜂窝开放平台，注册开发者账号，创建应用并申请商品/景点详情查询接口权限（o0b.cn/anzexi）
按照官方规范生成合法签名，将所有非空请求参数按要求排序后拼接密钥，生成验签值
用HTTPS POST方式将请求提交到马蜂窝API网关传入目标ID，即可直接返回标准JSON格式的结构化数据

三、可直接参考的标准成功返回JSON示例

这是脱敏后的标准返回结构，完全匹配马蜂窝开放平台官方接口的原生返回格式，核心字段都标注了业务含义，可直接用于开发调试参考：

{
  "code": 0,
  "msg": "success",
  "request_id": "req_20260903152218765",
  "data": {
    "item_id": "MFW202609001234",
    "title": "云南大理5天4晚跟团游 含洱海游船+大理古城+特色民宿",
    "dest_info": {
      "dest_id": "12345",
      "dest_name": "大理",
      "dest_province": "云南"
    },
    "price_info": {
      "market_price": "2999.00",
      "current_sale_price": "1699.00",
      "vip_price": "1599.00",
      "coupon_price": "1499.00",
      "coupon_desc": "满1500减100旅游专属券"
    },
    "sales_info": {
      "total_sales": 12680,
      "good_rate": "97.8%",
      "total_reviews": 5689,
      "is_official_authorized": true
    },
    "stock_info": {
      "total_stock": 326,
      "is_on_sale": true,
      "departure_dates": [
        "2026-09-10",
        "2026-09-17",
        "2026-09-24"
      ]
    },
    "image_info": {
      "main_images": [
        "https://n3-q.mafengwo.cn/img/abc123_1.jpg",
        "https://n3-q.mafengwo.cn/img/abc123_2.jpg",
        "https://n3-q.mafengwo.cn/img/abc123_3.jpg"
      ],
      "detail_images": [
        "https://n3-q.mafengwo.cn/img/def456_1.jpg",
        "https://n3-q.mafengwo.cn/img/def456_2.jpg"
      ]
    },
    "sku_list": [
      {
        "sku_id": "MFWSKU00123401",
        "spec_text": "成人票 9月10日出发",
        "sku_price": "1699.00",
        "sku_stock": 86
      },
      {
        "sku_id": "MFWSKU00123402",
        "spec_text": "儿童票 9月10日出发",
        "sku_price": "899.00",
        "sku_stock": 72
      }
    ],
    "refund_policy": {
      "support_full_refund_before": 7,
      "partial_refund_days": 3,
      "no_refund_before": 1
    },
    "travel_notes": "请携带有效期内身份证，出发前1天会有导游联系确认行程"
  }
}

技术实战：李宁（Lining）商品详情API接口技术解析与标准JSON返回参考

Wed, 02 Sep 2026 11:05:58 +0800

前言

在运动品牌电商选品、全渠道库存同步、多平台价格比价的业务场景中，李宁商品详情API是品牌电商从业者最核心的结构化数据入口。它无需搭建复杂的反爬代理体系，就能稳定获取全维度的李宁官方商品结构化信息，大幅降低运动品牌选品、库存监控类业务的开发门槛，是打通李宁品牌货源数据与自有电商系统的必备工具。

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

这套接口可以返回运动品牌电商业务开发中几乎所有需要的李宁商品核心字段，完全适配品牌选品、价格监控、正品溯源等多种场景：

基础标识：商品唯一ID（spu_id/sku_id）、商品官方名称、所属产品线（跑步/篮球/休闲等）、商品上架时间、品牌专属系列标识
价格体系：官方指导价、当前活动售价、会员专享价、限时折扣价、满减抵扣金额，所有价格数据支持分钟级更新
交易属性：全渠道累计销量、商品好评率、总评价数、官方正品授权标识、全国门店库存分布
规格库存：全SKU列表、每个子规格的对应售价、实时可售库存、颜色/尺码/款号等属性明细
素材资源：多尺寸主图数组、详情图列表、品牌官方宣传素材链接、商品3D展示资源地址
附加信息：商品参数详情（面料/科技/适用场景）、官方售后保障政策、全国联保服务说明、关联推荐同系列商品列表

二、最简接入操作步骤

结合之前其他品牌电商接口的开发经验，新手跟着3步就能快速完成适配调用：

登录李宁开放平台或品牌官方合作服务商后台，注册开发者账号，创建应用并申请商品详情查询接口权限，获取专属的App Key和App Secret（o0b.cn/anzexi）
按照官方规范生成合法签名，将所有非空请求参数按字典序排序后拼接密钥，通过HmacSHA256加密生成验签值
用HTTPS POST方式将请求提交到李宁API网关，传入目标商品SPU ID，即可直接返回标准JSON格式的结构化商品数据

三、可直接参考的标准成功返回JSON示例

这是脱敏后的标准返回结构，完全匹配李宁官方开放平台商品详情接口的原生返回格式，核心字段都标注了业务含义，可直接用于开发调试参考：

{
  "code": 0,
  "msg": "success",
  "request_id": "req_20260902143522678",
  "data": {
    "spu_id": "LN202609001234",
    "title": "李宁2026新款赤兔7 Pro 男子专业竞速跑步鞋 䨻科技缓震",
    "series_info": {
      "series_id": "LN_SERIES_001",
      "series_name": "赤兔竞速系列",
      "category": "跑步鞋"
    },
    "price_info": {
      "market_price": "599.00",
      "current_sale_price": "399.00",
      "vip_price": "369.00",
      "coupon_price": "349.00",
      "coupon_desc": "满399减50品牌专属券"
    },
    "sales_info": {
      "total_sales": 126890,
      "good_rate": "98.2%",
      "total_reviews": 56890,
      "is_official_authorized": true
    },
    "stock_info": {
      "total_stock": 32600,
      "is_on_sale": true,
      "store_stock_distribution": [
        {"province": "广东", "stock": 8600},
        {"province": "上海", "stock": 7200},
        {"province": "北京", "stock": 6800}
      ]
    },
    "image_info": {
      "main_images": [
        "https://static.lining.com/item/LN202609001234_1.jpg",
        "https://static.lining.com/item/LN202609001234_2.jpg",
        "https://static.lining.com/item/LN202609001234_3.jpg"
      ],
      "detail_images": [
        "https://static.lining.com/item/LN202609001234_4.jpg",
        "https://static.lining.com/item/LN202609001234_5.jpg"
      ]
    },
    "sku_list": [
      {
        "sku_id": "LNSKU00123401",
        "spec_text": "标准白 42码",
        "sku_price": "399.00",
        "sku_stock": 4600
      },
      {
        "sku_id": "LNSKU00123402",
        "spec_text": "竞速黑 43码",
        "sku_price": "399.00",
        "sku_stock": 5200
      },
      {
        "sku_id": "LNSKU00123403",
        "spec_text": "电光蓝 41码",
        "sku_price": "399.00",
        "sku_stock": 3800
      }
    ],
    "product_params": [
      {"name": "中底科技", "value": "䨻科技Light Foam Ultra"},
      {"name": "鞋面材质", "value": "MONO纱透气网面"},
      {"name": "适用场景", "value": "专业竞速跑步/日常训练"}
    ],
    "after_sale": {
      "support_return": true,
      "return_days": 7,
      "national_warranty": true,
      "warranty_months": 3
    }
  }
}