当前位置：首页 > article >正文

使用 Python 获取 1688 商品快递费用 API 接口的示例代码解析

article 2025/1/21 21:08:04

在电商运营中，了解商品的快递费用是优化成本和提升用户体验的重要环节。1688 提供了 item_fee API 接口，允许开发者获取指定商品的快递费用信息。本文将通过 Python 示例代码，详细解析如何调用该接口并处理返回的数据。

一、1688 商品快递费用 API 接口简介

item_fee 接口用于获取指定商品的快递费用信息。该接口支持多种参数，包括商品 ID、区域 ID、商品重量等，返回的数据包含首重费用、续重费用以及不同快递方式的费用详情。

二、开发准备

注册 1688 开放平台账号
访问 1688 开放平台，完成账号注册并创建应用，获取 API Key 和 API Secret。
安装依赖库
使用 requests 库发送 HTTP 请求，安装方法如下：

bash复制
```
pip install requests
```
获取必要的参数
- 商品 ID（num_iid）：需要查询快递费用的商品编号。
- 区域 ID（area_id）：收货地址的区域编码。
- 商品重量（unitweight）：商品的重量，单位为千克。

三、Python 示例代码

以下是一个完整的 Python 示例代码，展示如何调用 1688 item_fee API 接口并解析返回的快递费用信息。

Python

import requests
import hashlib
import time

# 1688 API 配置
API_URL = "https://api-gw.onebound.cn/1688/item_fee/"
API_KEY = "your_api_key"  # 替换为你的 API Key
API_SECRET = "your_api_secret"  # 替换为你的 API Secret

def generate_sign(params, secret):
    """
    生成签名
    :param params: 请求参数（字典格式）
    :param secret: API Secret
    :return: 签名字符串
    """
    sorted_params = sorted(params.items())
    sign_content = ''.join([f"{k}{v}" for k, v in sorted_params if k != 'sign'])
    sign_content += secret
    return hashlib.md5(sign_content.encode('utf-8')).hexdigest().upper()

def get_shipping_fee(num_iid, area_id, unitweight):
    """
    获取商品快递费用
    :param num_iid: 商品 ID
    :param area_id: 区域 ID
    :param unitweight: 商品重量（单位：千克）
    :return: 快递费用信息
    """
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "num_iid": num_iid,
        "area_id": area_id,
        "unitweight": unitweight,
        "timestamp": int(time.time())
    }
    params["sign"] = generate_sign(params, API_SECRET)
    
    response = requests.get(API_URL, params=params)
    
    if response.status_code == 200:
        return response.json()
    else:
        print(f"请求失败，状态码：{response.status_code}")
        return None

# 示例调用
if __name__ == "__main__":
    num_iid = "577523351572"  # 商品 ID
    area_id = "650100"  # 区域 ID，例如 650100 表示乌鲁木齐
    unitweight = "0.8"  # 商品重量（单位：千克）

    shipping_fee_data = get_shipping_fee(num_iid, area_id, unitweight)
    if shipping_fee_data:
        print("快递费用数据获取成功！")
        print(json.dumps(shipping_fee_data, indent=4, ensure_ascii=False))
    else:
        print("快递费用数据获取失败，请检查参数是否正确。")