×

Python 实现 1688 商品详情 API 数据准确性校验(直接可用 + JSON 参考)

知名用户18007905473 知名用户18007905473 发表于2026-04-29 14:57:55 浏览4 评论0

抢沙发发表评论

前言

给你极简、稳定、程序员专用的校验代码,用于 1688 商品详情 API 返回数据校验,确保数据准确、字段完整、格式合法,适合铺货、搬家、采购、数据分析。

一、校验核心(必检项)

  1. 返回 JSON 结构是否正确

  2. 商品 ID(offerId / 商品号)是否有效

  3. 标题是否存在且合法

  4. 价格必须 > 0

  5. 主图链接有效

  6. 库存 / 可售数量合法

  7. 类目、商家信息完整

  8. 过滤异常、空值、错误数据


二、Python 校验代码(直接复制用)

python
运行
def check_1688_item_accuracy(json_data):
    """
    1688商品详情API 数据准确性校验
    返回:(是否通过, 提示信息)
    """
    try:
        # 1. 校验返回根结构
        if "result" not in json_data:
            return False, "返回结构异常:无 result 节点"

        result = json_data["result"]
        if not result:
            return False, "未获取到商品数据"

        # 2. 商品ID校验(offerId 必须是数字)
        offer_id = result.get("offerId")
        if not offer_id or not str(offer_id).isdigit():
            return False, f"商品ID无效:{offer_id}"

        # 3. 标题校验(不能为空,长度合理)
        title = result.get("subject")
        if not title or len(title) < 5:
            return False, "商品标题无效或过短"

        # 4. 价格校验(必须 > 0)
        price = result.get("price", "0")
        try:
            price_val = float(price)
            if price_val <= 0:
                return False, f"商品价格异常:{price}"
        except:
            return False, f"价格格式错误:{price}"

        # 5. 主图校验(必须以 http/https 开头)
        pic_url = result.get("imageUrl")
        if not pic_url or "http" not in pic_url:
            return False, "商品主图无效"

        # 6. 库存/可售数量校验(不能为负)
        stock = result.get("amount", 0)
        try:
            stock_val = int(stock)
            if stock_val < 0:
                return False, f"库存数量异常:{stock}"
        except:
            pass

        # 7. 商家/公司信息校验
        seller = result.get("supplierName")
        if not seller:
            return False, "商家信息缺失"

        # 全部校验通过
        return True, "1688商品数据校验通过,准确有效"

    except Exception as e:
        return False, f"校验异常:{str(e)}"

三、1688 商品详情 API 标准 JSON 返回参考

json
{
  "result": {
    "offerId": "1234567890",
    "subject": "2025新款纯棉短袖T恤工厂直供",
    "price": "19.50",
    "imageUrl": "https://cbu01.alicdn.com/xxx.jpg",
    "amount": 5000,
    "categoryId": 123456,
    "supplierName": "XX服饰有限公司",
    "detailUrl": "https://detail.1688.com/offer/xxx.html"
  },
  "code": 200,
  "success": true}

四、使用方法

python
运行
# 调用1688 API 获取JSONjson_result = requests.get(api_url, params=params).json()# 执行校验is_ok, msg = check_1688_item_accuracy(json_result)print(is_ok, msg)

五、能帮你避免哪些问题?

  • 商品数据为空导致程序崩溃

  • 价格异常、负数、0 元导致铺货错误

  • 商品 ID 无效导致无法搬家

  • 图片失效导致上货失败

  • 字段缺失导致数据分析出错

  • API 异常返回不被发现


六、一句话总结

1688 商品 API 校验 = 结构正确 + 字段完整 + 数值合法
让你的商品搬家、自动铺货、采购比价、数据分析100% 稳定不出错。


群贤毕至

访客