你需要一份结构化的微店商品快递费用 API 使用指南，涵盖摘要、接口概述、Python 请求示例和结语四个核心部分，用于理解和实际调用该 API。以下是完整且可落地的指南内容：
一、摘要
微店商品快递费用 API 是微店开放平台提供的核心接口之一，主要用于查询指定商品在不同收货地址、购买数量 / 规格下的快递费用。该接口支持开发者将运费计算功能集成到自有系统（如订单管理系统、商品展示页面），实现运费的自动化、精准化计算，避免人工核算误差，提升订单处理效率。
二、接口概述
1. 基础信息
| 项 | 说明 |
|---|---|
| 接口地址 | 正式环境：c0b.cc/R4rbK2 (前往体验接口测试，Taobaoapi2014添加V获取） |
| 请求方式 | POST |
| 数据格式 | JSON（请求 / 响应均为 JSON 格式） |
| 授权方式 | 基于app_key+app_secret生成签名（sign），需在请求参数中携带 |
2. 请求参数
（1）公共参数（所有接口必传）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| method | string | 是 | 接口方法名，快递费用查询固定为：vdian.shop.express.fee.get |
| app_key | string | 是 | 微店开放平台申请的应用 ID |
| timestamp | string | 是 | 时间戳（格式：yyyy-MM-dd HH:mm:ss，如：2025-12-30 10:00:00） |
| format | string | 是 | 响应格式，固定为：json |
| v | string | 是 | 接口版本号，固定为：1.0 |
| sign | string | 是 | 签名值（通过 app_secret 对参数排序后 MD5 加密生成） |
（2）业务参数（快递费用查询专属）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_id | string | 是 | 微店商品 ID（可从商品管理接口获取） |
| province | string | 是 | 收货省份（如：北京市、浙江省） |
| city | string | 是 | 收货城市（如：北京市、杭州市） |
| district | string | 否 | 收货区县（如：朝阳区、西湖区），部分快递需精准到区县 |
| num | int | 是 | 购买数量，默认值：1 |
| spec_id | string | 否 | 商品规格 ID（多规格商品必填，单规格商品无需传） |
3. 响应参数
（1）成功响应
json
{ "status": 0, // 状态码：0=成功，非0=失败 "msg": "success", // 提示信息 "result": { "express_fee": 10.0, // 快递费用（单位：元） "express_name": "中通快递", // 快递公司名称 "free_fee_threshold": 99.0 // 包邮门槛（满99元包邮） } }（2）失败响应
json
{ "status": 1001, // 错误码 "msg": "商品ID不存在", // 错误描述 "result": null }4. 常见错误码
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 1001 | 商品 ID 不存在 | 核对 product_id 是否正确 |
| 1002 | 收货地址不支持配送 | 检查地址是否在配送范围内 |
| 2001 | 签名验证失败 | 核对 app_secret 和签名算法 |
| 3001 | 接口调用频率超限 | 降低调用频率（默认 60 次 / 分钟） |
三、Python 请求示例
1. 前置准备
- 先安装依赖库：
bash
pip install requests # 发送HTTP请求 pip install hashlib # 生成MD5签名（Python内置，一般无需额外安装）- 从微店开放平台获取：
app_key、app_secret、product_id（需先完成开发者认证和应用创建）。
2. 完整代码示例
python
3. 代码说明
generate_sign函数：严格按照微店开放平台的签名规则生成签名，这是接口调用成功的核心（签名错误会直接返回 2001 错误）；get_express_fee函数：封装了参数构造、签名生成、请求发送、响应解析的全流程，包含超时和异常处理；- 测试调用部分：替换
product_id、province等参数即可直接运行，返回结果包含是否成功、运费、快递公司、包邮门槛等关键信息。
四、结语
- 微店快递费用 API 的调用核心是签名正确和参数完整，建议先在测试环境调试通过后再切换到正式环境；
- 实际开发中，建议对接口调用结果增加日志记录，方便排查问题；
- 若需批量查询运费，需注意接口频率限制（默认 60 次 / 分钟），可通过延时调用避免超限；
- 微店开放平台的接口规范可能会更新，确保代码适配最新规则。
总结
- 微店快递费用 API 的核心是通过
app_key/app_secret授权，传入商品 ID、收货地址等参数查询运费； - Python 调用的关键步骤：构造参数→生成签名→发送 POST 请求→解析响应，其中签名生成是避免调用失败的核心；
- 实际使用时需注意参数校验、频率限制和异常处理，确保接口调用稳定可靠。
