一、引言
当当网商品详情API(dangdang.item.get)是当当开放平台提供的核心接口之一,主要用于获取商品的详细信息。该接口支持图书、电子书等多种商品类型的数据查询,为开发者提供了丰富的商品数据获取能力。
二、接口概述
1. 接口功能
- 基础信息:商品ID、ISBN、标题、作者/出版社信息等。
- 价格体系:原价、促销价、会员价等。
- 库存状态:实时库存量及区域仓库存分布。
- 多媒体数据:封面图、详情图、视频链接等。
- 销售数据:累计销量、评分、评论数等。
- 商品属性:分类信息、页数、开本等图书特征。
2. 请求方式
支持GET和POST两种请求方式,返回格式支持XML和JSON。
三、Python请求示例
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "
app_key = "YOUR_APP_KEY" num_id = "123456789" # 目标商品ID
# 请求示例 url 默认请求参数已经做URL编码
url = "dangdang/item_get/&key=<您自己的apiKey>=2216eb00&num_iid=25122027"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
代码功能说明:
- 实现了当当商品详情API的完整调用流程,包括参数构造、签名生成和请求发送。
- 使用MD5算法生成请求签名,确保接口安全性。
- 支持JSON格式的响应数据解析。
- 包含错误处理机制,当API请求失败时会抛出异常。