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

API小知识
70 阅读4分钟

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

一、准备工作

  1. 注册1688开放平台账号

    首先，你需要在1688开放平台注册一个账号，并申请相应的API权限。在申请过程中，你需要提供必要的开发者信息，并获取应用的AppKey和AppSecret。

  2. 安装必要的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：签名，必填项，用于验证请求的合法性。

三、生成签名

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

  1. 将请求参数按照参数名ASCII码从小到大排序（字典序）。
  2. 拼接参数名和参数值，用&连接，如app_key=your_app_key&fields=title,price&num_iid=123456&sign_method=md5&timestamp=1628304000。
  3. 在拼接好的字符串末尾加上&secret=your_secret（your_secret为你的应用密钥）。
  4. 使用指定的签名方式（如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:
avatar
文章
阅读
粉丝