在电商开发领域摸爬滚打这些年，踩过不少API的坑，也总结出了不少实战经验。今天就来唠唠商品详情API接口的那些事儿，顺便分享一些自己写的代码片段，都是实打实调试过的干货。
记得之前做一个比价小程序项目，需要从多个电商平台抓取商品详情。最开始天真地以为调用API就是简单发个请求，拿到数据解析就行。结果第一个坑就栽在淘宝API上——人家对调用频率限制特别严格，稍微频繁一点就返回429错误。没办法，只能自己写了个频率控制的装饰器：
import time from functools import wraps def rate_limit(max_calls, period): call_times = [] def decorator(func): @wraps(func) def wrapper(*args, **kwargs): current_time = time.time() call_times[:] = [t for t in call_times if current_time - t < period] if len(call_times) >= max_calls: raise Exception(f"请求频率超过限制：{max_calls}次/{period}秒") call_times.append(current_time) return func(*args, **kwargs) return wrapper return decorator # 使用示例 class CustomAPI: @rate_limit(max_calls=50, period=60) def get_product_detail(self, product_id, platform): # 实际请求代码 pass
解决了频率问题，又遇到数据格式不统一的难题。京东、拼多多返回的JSON结构和淘宝差别很大，尤其是商品属性字段命名千奇百怪。那段时间天天对着三个平台的API文档做字段映射，写了一堆适配代码。后来学聪明了，抽象出一个数据格式化函数：
def format_product_data(raw_data, platform): if platform == "taobao": return { "title": raw_data.get("title", ""), "price": raw_data.get("price_info", {}).get("current_price", 0), "stock": raw_data.get("stock_info", {}).get("available", 0) } elif platform == "jd": return { "title": raw_data.get("name", ""), "price": raw_data.get("jd_price", 0), "stock": raw_data.get("quantity", 0) } # 其他平台适配 return {}
还有一次印象特别深，当时服务器半夜突然报警，查日志发现是API返回数据格式变了。原来平台做了版本升级，但文档没及时更新。吃一堑长一智，后来每次调用API都会加一层数据校验：
def validate_product_data(data): required_fields = ["title", "price", "stock"] for field in required_fields: if field not in data: raise ValueError(f"缺少必要字段: {field}") return True
在缓存处理上也走过弯路。最开始简单用字典做内存缓存，结果服务器一重启数据全丢。后来改用Redis，配合cachetools库实现了带过期时间的缓存：
import cachetools from cachetools import TTLCache import redis redis_client = redis.Redis(host='localhost', port=6379, db=0) def redis_cache(key, ttl=300): def decorator(func): def wrapper(*args, **kwargs): cached_data = redis_client.get(key) if cached_data: return eval(cached_data) result = func(*args, **kwargs) redis_client.setex(key, ttl, str(result)) return result return wrapper return decorator # 使用示例 @redis_cache(key="product:12345", ttl=600) def get_cached_product_detail(product_id): # 实际请求代码 pass
这些年接触过不少API服务商，总结出几个挑选的实用标准：首先看错误码文档是否详细，遇到问题能快速定位；其次测试响应速度，超过500ms的基本就不考虑了；最后一定要有历史调用记录查询功能，排查问题特别有用。
现在做项目，都会先写个简易的测试脚本，专门用来调试API。把请求参数、响应结果、错误信息都打印出来，还会加一些断言：
import unittest class TestProductAPI(unittest.TestCase): def setUp(self): self.api = CustomAPI() def test_get_product_detail(self): result = self.api.get_product_detail("12345", "taobao") self.assertEqual(isinstance(result, dict), True) self.assertTrue("title" in result) if __name__ == '__main__': unittest.main()
这些代码都是从实际项目里抠出来的片段，虽然不是完整工程，但每个功能都经过反复调试。希望这些实战经验和代码示例，能给正在做电商开发的朋友一些启发。如果在API调用上遇到啥奇葩问题，欢迎评论区交流，一个专攻电商API数据程序猿。
