要使用API接口实现淘宝商品上下架监控,需遵循以下技术方案:
一、核心API接口选择
-
商品状态查询接口 (推荐
taobao.item.get
)- 接口功能:获取单个商品详细信息(含上下架状态)
- 必选参数:
num_iid
(商品ID)、fields
(需包含approve_status
字段) - 响应字段:
item.approve_status
(ENUM值:onsale/instock)
-
批量商品查询接口 (推荐
taobao.items.inventory.get.tmall
)- 接口功能:获取卖家仓库商品列表
- 过滤参数:
banner=for_shelved
(查询所有未上架商品) - 响应字段:
items.item.approve_status
二、认证授权流程
csharp
python
# 签名生成示例(MD5算法)
def generate_sign(params, app_secret):
sorted_params = sorted(params.items())
sign_str = app_secret + ''.join([f"{k}{v}" for k, v in sorted_params]) + app_secret
return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
# OAuth2.0获取AccessToken(简化版)
def get_access_token(app_key, app_secret):
url = "https://oauth.taobao.com/token"
params = {
"grant_type": "client_credentials",
"client_id": app_key,
"client_secret": app_secret
}
response = requests.post(url, data=params)
return response.json().get('access_token')
三、监控逻辑实现
python
python
class ItemMonitor:
def __init__(self, app_key, app_secret):
self.app_key = app_key
self.app_secret = app_secret
self.access_token = get_access_token(app_key, app_secret)
self.last_states = {}
def check_item_status(self, item_id):
# 调用商品详情接口
url = "https://eco.taobao.com/router/rest"
params = {
"method": "taobao.item.get",
"app_key": self.app_key,
"timestamp": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
"v": "2.0",
"format": "json",
"num_iid": item_id,
"fields": "num_iid,title,approve_status"
}
params['sign'] = generate_sign(params, self.app_secret)
response = requests.get(url, params=params)
# 解析响应
if response.status_code == 200:
data = response.json()
current_status = data.get('taobao_item_get_response', {}).get('item', {}).get('approve_status')
return current_status
return None
def monitor_loop(self, item_id, interval=300):
while True:
current_status = self.check_item_status(item_id)
last_status = self.last_states.get(item_id)
if current_status != last_status:
self.last_states[item_id] = current_status
self.send_notification(item_id, current_status)
time.sleep(interval)
def send_notification(self, item_id, status):
# 实现通知逻辑(邮件/短信/企业微信等)
print(f"商品{item_id}状态变更:{status}")
四、部署与运维
-
服务器部署
cssbash # 安装依赖 pip install requests top # 启动监控(示例) python monitor.py --app_key=your_key --app_secret=your_secret --item_id=123456
-
定时任务配置(Linux Cron)
bashbash # 每5分钟检查一次 */5 * * * * /usr/bin/python3 /path/to/monitor.py >> /var/log/taobao_monitor.log 2>&1
五、高级功能扩展
-
批量监控实现
rubypython def batch_monitor(self, item_ids): for item_id in item_ids: threading.Thread(target=self.monitor_loop, args=(item_id, 300)).start()
-
状态持久化存储
pythonpython def save_state(self): with open("status.json", "w") as f: json.dump(self.last_states, f) def load_state(self): if os.path.exists("status.json"): with open("status.json", "r") as f: self.last_states = json.load(f)
六、注意事项
-
调用频率限制:淘宝API对未认证应用限制10次/秒,认证后提升至50次/秒
-
错误重试机制:
pythonpython def safe_request(func): def wrapper(*args, **kwargs): for _ in range(3): try: return func(*args, **kwargs) except (requests.ConnectionError, requests.Timeout): time.sleep(2) continue except Exception as e: logging.error(f"请求失败: {str(e)}") break return None return wrapper
该方案通过定时调用商品状态接口,结合状态持久化存储和差异检测,可实现高效的商品上下架监控。实际部署时建议结合企业微信/钉钉机器人实现实时告警,并配置数据库存储状态变更历史。