如何使用 Python 开发 1688 商品详情 API 接口？

2024-11-18
江西
本文字数：3031 字
阅读完需：约 10 分钟

在现代软件开发中，API 接口扮演着重要角色，它们允许开发者之间共享数据和功能。1688 作为中国最大的 B2B 交易平台，提供了丰富的商品数据。通过开发 1688 商品详情 API 接口，开发者可以获取商品的详细信息，如标题、价格、销量和评价等。本文将详细介绍如何使用 Python 开发 1688 商品详情 API 接口。

一、准备工作

注册 1688 开放平台账号
首先，你需要在 1688 开放平台注册一个账号，并申请相应的 API 权限。在申请过程中，你需要提供必要的开发者信息，并获取应用的 AppKey 和 AppSecret。
安装必要的 Python 模块
为了发送 HTTP 请求和解析返回的数据，你需要安装一些 Python 模块。常用的模块包括requests、hashlib、time和urllib.parse。你可以使用 pip 命令进行安装：

    bash      pip install requests

复制代码

二、了解 1688 商品详情 API 接口

1688 商品详情 API 接口提供了获取商品详细信息的接口，支持 HTTP GET 和 POST 请求，返回格式为 JSON。以下是接口的一些关键信息：

接口 URL：https://api.1688.com/item/get_item_detail.do
请求参数：
num_iid：商品 ID，必填项，用于指定要查询的商品。
fields：可选参数，用于指定返回的商品详情字段，多个字段用逗号分隔。如果不指定该参数，则返回默认字段集。
app_key：应用 APPKEY，必填项，用于身份验证。
sign_method：签名方式，可选参数，默认为 md5。
timestamp：请求时间戳，必填项，用于防止请求重放。
format：返回格式，可选参数，默认为 json。
sign：签名，必填项，用于验证请求的合法性。

三、生成签名

签名是确保请求合法性的重要步骤。以下是生成签名的步骤：

将请求参数按照参数名 ASCII 码从小到大排序（字典序）。
拼接参数名和参数值，用&连接，如app_key=your_app_key&fields=title,price&num_iid=123456&sign_method=md5&timestamp=1628304000。
在拼接好的字符串末尾加上&secret=your_secret（your_secret为你的应用密钥）。
使用指定的签名方式（如 md5）对拼接好的字符串进行签名。

四、编写 Python 代码

以下是一个使用 Python 请求 1688 商品详情接口的示例代码：

python  import requests  import hashlib  import time  import urllib.parse     # 请求参数  app_key = 'your_app_key'  secret = 'your_secret'  num_iid = '123456'  # 商品ID  fields = 'title,price,desc,pic_url'  # 要返回的商品详情字段  timestamp = str(int(time.time()))  # 当前时间戳  sign_method = 'md5'  format = 'json'     # 生成签名  params = {      'app_key': app_key,      'fields': fields,      'num_iid': num_iid,      'sign_method': sign_method,      'timestamp': timestamp,      'format': format  }
  params_str = '&'.join(['{}={}'.format(k, urllib.parse.quote(str(v))) for k, v in sorted(params.items(), key=lambda item: item[0])])  sign_str = params_str + '&secret=' + secret  sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()     # 发送请求  url = 'https://api.1688.com/item/get_item_detail.do'  headers = {'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'}  data = {      'app_key': app_key,      'fields': fields,      'num_iid': num_iid,      'sign_method': sign_method,      'timestamp': timestamp,      'format': format,      'sign': sign  }  response = requests.post(url, data=data, headers=headers)     # 处理响应  if response.status_code == 200:      result = response.json()      print(result)  else:      print('Request failed with status code:', response.status_code)

复制代码

五、解析返回的数据

如果请求成功，1688 商品详情 API 接口将返回一个 JSON 格式的数据。你可以使用 Python 的内置函数json.loads()将 JSON 字符串解析为 Python 字典，然后访问字典中的键来获取所需的商品信息。

例如，假设返回的 JSON 数据如下：

json  {      "item": {          "title": "商品标题",          "price": "100.00",          "desc": "商品描述",          "pic_url": "https://example.com/image.jpg"      }  }

复制代码

你可以使用以下代码解析并访问商品信息：

python  if response.status_code == 200:      result = response.json()      item = result.get('item')      if item:          title = item.get('title')          price = item.get('price')          desc = item.get('desc')          pic_url = item.get('pic_url')          print(f"商品标题: {title}")          print(f"商品价格: {price}")          print(f"商品描述: {desc}")          print(f"商品图片URL: {pic_url}")  else:      print('Request failed with status code:', response.status_code)

复制代码

六、错误处理和日志记录

在实际开发中，错误处理和日志记录是非常重要的。你可以使用 Python 的try-except语句来捕获和处理异常，并使用logging模块来记录日志。如遇任何疑问或有进一步的需求，请随时与我私信联系或者评论。

以下是一个包含错误处理和日志记录的示例代码：

python  import requests  import hashlib  import time  import urllib.parse  import logging     # 配置日志记录  logging.basicConfig(level=logging.INFO,format='%(asctime)s - %(levelname)s - %(message)s')    # 请求参数  app_key = 'your_app_key'  secret = 'your_secret'  num_iid = '123456'  # 商品ID  fields = 'title,price,desc,pic_url'  # 要返回的商品详情字段  timestamp = str(int(time.time()))  # 当前时间戳  sign_method = 'md5'  format = 'json'     # 生成签名  params = {      'app_key': app_key,      'fields': fields,      'num_iid': num_iid,      'sign_method': sign_method,      'timestamp': timestamp,      'format': format  }
  params_str = '&'.join(['{}={}'.format(k, urllib.parse.quote(str(v))) for k, v in sorted(params.items(), key=lambda item: item[0])])  sign_str = params_str + '&secret=' + secret  sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()     # 发送请求  url = 'https://api.1688.com/item/get_item_detail.do'  headers = {'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'}  data = {      'app_key': app_key,      'fields': fields,      'num_iid': num_iid,      'sign_method': sign_method,      'timestamp': timestamp,      'format': format,      'sign': sign  }     try:      response = requests.post(url, data=data, headers=headers)      response.raise_for_status()  # 如果响应状态码不是200，将引发HTTPError异常      result = response.json()      item = result.get('item')      if item:          title = item.get('title')          price = item.get('price')          desc = item.get('desc')          pic_url = item.get('pic_url')          logging.info(f"商品标题: {title}")          logging.info(f"商品价格: {price}")          logging.info(f"商品描述: {desc}")          logging.info(f"商品图片URL: {pic_url}")  except requests.exceptions.RequestException as e:

复制代码

发布于: 刚刚阅读数: 5

原文链接:【http://xie.infoq.cn/article/5ce8e0b8e19d10c529e669e14】。文章转载请联系作者。

科普小能手

关注

还未添加个人签名 2024-09-26 加入

还未添加个人简介

发布

暂无评论

创作场景

如何使用 Python 开发 1688 商品详情 API 接口？

一、准备工作

二、了解 1688 商品详情 API 接口

三、生成签名

四、编写 Python 代码

五、解析返回的数据

六、错误处理和日志记录

科普小能手

评论