1688 跨境寻源通详情接口深度解析：从接入到实战

# 1. 引导用户授权
GET https://open.1688.com/auth/authorize.htm?
  response_type=code&
  client_id=YOUR_APP_KEY&
  redirect_uri=YOUR_CALLBACK_URL

# 2. 用授权码换取 access_token
POST https://open.1688.com/openapi/http/1/system.oauth2/getToken/2.0
  grant_type=authorization_code&
  client_id=YOUR_APP_KEY&
  client_secret=YOUR_APP_SECRET&
  code=AUTHORIZATION_CODE

import hashlibdef generate_sign(params, app_secret):
    # 1. 移除 sign 参数，按参数名 ASCII 升序排序
    sorted_params = sorted((k, v) for k, v in params.items() if k != 'sign')
    # 2. 拼接字符串：app_secret + key1value1key2value2... + app_secret
    sign_str = app_secret + ''.join(f"{k}{v}" for k, v in sorted_params) + app_secret    # 3. MD5 加密并转大写
    return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()

{
  "success": true,
  "result": {
    "productId": 619899292404,
    "subject": "夏季新款纯棉T恤男款宽松短袖",
    "imageUrl": "https://cbu01.alicdn.com/img/ibank/...jpg",
    "priceRanges": [
      {
        "startQuantity": 1,
        "price": "28.00",
        "currency": "CNY"
      },
      {
        "startQuantity": 100,
        "price": "22.50",
        "currency": "CNY"
      }
    ],
    "skuInfo": {
      "skuItems": [
        {
          "skuId": "123456",
          "attributes": [
            {"attributeName": "颜色", "attributeValue": "白色"},
            {"attributeName": "尺码", "attributeValue": "XL"}
          ],
          "price": "28.00",
          "amountOnSale": 500
        }
      ]
    },
    "saleInfo": {
      "unit": "件",
      "minOrderQuantity": 1,
      "batchNumber": 1
    },
    "shippingInfo": {
      "deliveryFee": {
        "originalCost": "0.00",
        "type": "FREE"
      },
      "sendGoodsAddress": "浙江省杭州市"
    },
    "supplier": {
      "loginId": "xxx.1688.com",
      "companyName": "杭州xxx服饰有限公司",
      "isGoldSupplier": true,
      "yearsAsSupplier": 5
    }
  }}

import requestsimport timeimport hashlibimport urllib.parseclass AlibabaAPI:
    def __init__(self, app_key, app_secret, access_token):
        self.app_key = app_key
        self.app_secret = app_secret
        self.access_token = access_token
        self.gateway = "https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.get"
    
    def get_product_detail(self, product_id, fields=None):
        params = {
            'app_key': self.app_key,
            'method': 'com.alibaba.product.alibaba.product.get',
            'timestamp': time.strftime('%Y-%m-%d %H:%M:%S'),
            'v': '2.0',
            'format': 'json',
            'access_token': self.access_token,
            'productId': product_id        }
        
        if fields:
            params['fields'] = fields        
        # 生成签名
        params['sign'] = self._generate_sign(params)
        
        # 发送 POST 请求
        headers = {'Content-Type': 'application/x-www-form-urlencoded'}
        response = requests.post(self.gateway, data=params, headers=headers)
        
        if response.status_code == 200:
            data = response.json()
            if data.get('success'):
                return data['result']
            else:
                raise Exception(f"API Error: {data.get('errorMessage')}")
        else:
            raise Exception(f"HTTP Error: {response.status_code}")
    
    def _generate_sign(self, params):
        sorted_params = sorted((k, v) for k, v in params.items() if k != 'sign')
        sign_str = self.app_secret + ''.join(f"{k}{v}" for k, v in sorted_params) + self.app_secret        return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()# 使用示例api = AlibabaAPI(
    app_key="your_app_key",
    app_secret="your_app_secret",
    access_token="your_access_token")# 获取商品详情（指定字段）product = api.get_product_detail(
    product_id=610947572360,
    fields="subject,priceRanges,skuInfo,saleInfo,shippingInfo")print(f"商品标题: {product['subject']}")print(f"价格梯度: {product['priceRanges']}")