技术实战：震坤行（ZKH）API 详情接口技术解析与标准JSON返回参考
前言
震坤行工业超市（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天无理由退货（未使用）"
}
}
}