微店商品详情API接口设计与调用指南

JelenaAPI小小爬虫

于 2025-02-24 17:27:32 发布

阅读量927

点赞数 18

分类专栏：微店API 文章标签： python linux 开发语言

本文链接：https://blog.csdn.net/2401_89446003/article/details/145833628

版权

微店API 专栏收录该内容

6 篇文章

订阅专栏

在电商运营中，商品详情数据是商家管理商品、优化用户体验以及进行数据分析的重要基础。微店作为国内知名的电商平台，提供了丰富的API接口，帮助开发者和商家高效获取商品详情信息。本文将详细介绍微店商品详情API接口的设计、调用方法、安全实践以及异常处理，帮助开发者快速上手并高效使用该接口。

一、微店商品详情API接口概述

微店商品详情API接口（micro.item_get）允许开发者通过商品ID获取商品的详细信息，包括基础信息、SKU数据、库存、价格、图片、描述等。该接口采用RESTful风格，返回数据格式为JSON，具有高效、灵活的特点。

接口功能

基础信息：商品标题、价格、库存、描述等。
SKU信息：不同规格（如颜色、尺寸）的详细信息。
图片信息：商品主图、详情页图片等。
销售信息：销量、评价等。

接口优势

数据全面：提供商品的多维度信息，满足不同场景需求。
实时性高：支持实时获取最新商品数据。
安全性强：采用OAuth 2.0授权机制和签名验证。

二、调用微店商品详情API接口

（一）注册与认证

注册开发者账号：访问微店开放平台，注册成为开发者。
创建应用：登录开放平台，创建应用并获取App Key和App Secret。
申请权限：为应用申请商品详情接口的使用权限，等待审核通过。

（二）获取Access Token

许多API接口调用需要使用Access Token。可以通过以下方式获取：

http

POST https://open.weidian.com/api/oauth2/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET

响应示例：

JSON

{
  "access_token": "YOUR_ACCESS_TOKEN",
  "expires_in": 7200,
  "scope": "all"
}

（三）构建HTTP请求

根据API文档，构建HTTP请求来调用商品详情接口。请求通常包括以下参数：

app_key：应用密钥。
access_token：访问令牌。
item_id：商品ID。
timestamp：时间戳。
sign：签名，用于验证请求的合法性。

（四）签名生成

签名是接口调用的关键环节，用于确保请求的安全性。签名生成步骤如下：

按字典序排序请求参数。
拼接参数名和参数值，格式为参数名1=参数值1&参数名2=参数值2。
在字符串首尾添加App Secret。
使用MD5加密生成签名。

（五）Python调用示例

以下是一个使用Python和requests库调用微店商品详情API的完整示例：

Python

import requests
import hashlib
import time

# 配置信息
APP_KEY = "your_app_key"
APP_SECRET = "your_app_secret"
ACCESS_TOKEN = "your_access_token"
ITEM_ID = "12345678"

# 生成签名
def generate_sign(params):
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    param_str = "".join([f"{k}{v}" for k, v in sorted_params])
    sign_str = APP_SECRET + param_str + APP_SECRET
    sign = hashlib.md5(sign_str.encode()).hexdigest().upper()
    return sign

# 调用商品详情接口
def get_item_detail(item_id):
    params = {
        "app_key": APP_KEY,
        "access_token": ACCESS_TOKEN,
        "item_id": item_id,
        "format": "json",
        "v": "1.0",
        "timestamp": str(int(time.time()))
    }
    params["sign"] = generate_sign(params)

    url = "https://api.weidian.com/item/get"
    response = requests.get(url, params=params)

    if response.status_code == 200:
        result = response.json()
        if result.get("status", {}).get("status_code") == 0:
            return result.get("result")
        else:
            print(f"接口错误: {result.get('status', {}).get('status_reason')}")
    else:
        print(f"请求失败，状态码: {response.status_code}")

# 示例调用
item_data = get_item_detail(ITEM_ID)
if item_data:
    print(f"商品标题：{item_data['title']}")
    print(f"当前价格：{item_data['price']}元")
    print(f"可用库存：{item_data['stock']}件")