?

摘要：本文將詳細(xì)介紹如何調(diào)用1688開(kāi)放平臺(tái)提供的API接口，通過(guò)商品ID精確獲取商品的詳細(xì)信息。內(nèi)容包括接口概述、請(qǐng)求方式、參數(shù)說(shuō)明、返回?cái)?shù)據(jù)結(jié)構(gòu)解析以及調(diào)用示例。

1. 接口概述

1688開(kāi)放平臺(tái)提供了 獲取商品詳情 接口，允許開(kāi)發(fā)者通過(guò)傳入商品ID來(lái)查詢?cè)撋唐返脑敿?xì)信息。該接口返回的數(shù)據(jù)結(jié)構(gòu)包含了商品的基礎(chǔ)屬性、價(jià)格、庫(kù)存、圖片、規(guī)格等關(guān)鍵信息。

2. 請(qǐng)求方式

接口名稱：獲取商品詳情

請(qǐng)求方法：HTTP POST

請(qǐng)求地址：https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.get

數(shù)據(jù)格式：application/x-www-form-urlencoded

3. 請(qǐng)求參數(shù)

調(diào)用該接口需要傳遞以下關(guān)鍵參數(shù)：

access_token：String 類型。調(diào)用API的身份授權(quán)令牌，需通過(guò)1688開(kāi)放平臺(tái)的OAuth2.0授權(quán)流程獲取。必須。

productId：Long 類型。目標(biāo)商品的唯一ID。必須。

fields (可選)：String 類型。用于指定需要返回的字段列表，多個(gè)字段用英文逗號(hào)分隔。若不指定，默認(rèn)返回所有字段。

示例：fields=subject,priceRanges,imageUrl,skuInfo

4. 返回?cái)?shù)據(jù)結(jié)構(gòu)解析

接口成功調(diào)用后，會(huì)返回一個(gè)結(jié)構(gòu)化的JSON數(shù)據(jù)。核心字段包括：

{
  "result": {
    "productId": 123456789012345, // 商品ID
    "subject": "商品標(biāo)題", // 商品標(biāo)題
    "priceRanges": [ // 價(jià)格區(qū)間
      {
        "startQuantity": 1, // 起批量
        "price": 99.99 // 價(jià)格
      },
      // ... 其他價(jià)格區(qū)間
    ],
    "imageUrl": "https://example.com/image.jpg", // 主圖URL
    "detailPage": "https://detail.1688.com/offer/123456789012345.html", // 詳情頁(yè)URL
    "skuInfo": { // SKU信息
      "skuMap": { // SKU屬性映射
        "顏色;尺寸": {
          "skuId": "sku123", // SKU ID
          "specId": "spec123", // 規(guī)格ID
          "price": 99.99, // SKU價(jià)格
          "stock": 100 // SKU庫(kù)存
        }
        // ... 其他SKU組合
      },
      "specs": [ // 規(guī)格定義
        {
          "specId": "spec123", // 規(guī)格ID
          "name": "顏色", // 規(guī)格名稱
          "values": [ // 規(guī)格值
            {
              "valueId": "value1",
              "name": "紅色"
            },
            {
              "valueId": "value2",
              "name": "藍(lán)色"
            }
          ]
        },
        // ... 其他規(guī)格
      ]
    },
    "status": "published", // 商品狀態(tài) (published, deleted等)
    // ... 其他字段 (如物流信息、服務(wù)承諾、描述信息等)
  },
  "success": true, // 請(qǐng)求是否成功
  "errorCode": "0", // 錯(cuò)誤碼 (0表示成功)
  "errorMsg": null // 錯(cuò)誤信息
}

5. 調(diào)用示例 (Python)

import requests

# 你的AppKey、AppSecret、AccessToken (實(shí)際應(yīng)用中需安全存儲(chǔ))
app_key = 'YOUR_APP_KEY'
app_secret = 'YOUR_APP_SECRET'
access_token = 'YOUR_ACCESS_TOKEN'

# 目標(biāo)商品ID
product_id = 123456789012345  # 替換為實(shí)際商品ID

# API請(qǐng)求地址
url = 'https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.get'

# 構(gòu)建請(qǐng)求參數(shù)
params = {
    'access_token': access_token,
    'productId': product_id,
    # 'fields': 'subject,priceRanges,imageUrl,skuInfo'  # 可選，按需指定字段
}

# 發(fā)送POST請(qǐng)求
response = requests.post(url, data=params)

# 處理響應(yīng)
if response.status_code == 200:
    data = response.json()
    if data.get('success'):
        product_info = data['result']
        print("商品標(biāo)題:", product_info['subject'])
        print("主圖URL:", product_info['imageUrl'])
        # 解析價(jià)格區(qū)間、SKU等信息...
    else:
        print("API調(diào)用失敗:", data.get('errorMsg', '未知錯(cuò)誤'))
else:
    print("HTTP請(qǐng)求失敗，狀態(tài)碼:", response.status_code)

注意事項(xiàng)：

確保 access_token 有效且具有足夠的權(quán)限。

productId 必須是有效的1688商品ID (長(zhǎng)整型)。

根據(jù)業(yè)務(wù)需求合理使用 fields 參數(shù)，避免請(qǐng)求過(guò)多不必要的數(shù)據(jù)。

注意接口調(diào)用頻率限制，避免觸發(fā)流控。

處理可能的錯(cuò)誤碼 (如 isv.invalid-parameter, isp.permission-denied 等)。

6. 常見(jiàn)問(wèn)題

Q：如何獲取 access_token？ A：需要通過(guò)1688開(kāi)放平臺(tái)的OAuth2.0授權(quán)流程獲取。開(kāi)發(fā)者需在開(kāi)放平臺(tái)創(chuàng)建應(yīng)用，引導(dǎo)用戶授權(quán)后獲取授權(quán)碼(code)，再換取訪問(wèn)令牌(access_token)。

Q：返回的圖片URL是完整的嗎？ A：通常返回的是圖片的相對(duì)路徑或包含域名的主路徑。建議拼接1688的圖片域名前綴 (如 https://cbu01.alicdn.com/) 或直接使用返回的完整URL。

Q：如何獲取實(shí)時(shí)庫(kù)存？ A：此接口返回的庫(kù)存信息 (stock) 可能不是實(shí)時(shí)更新的。對(duì)于需要實(shí)時(shí)庫(kù)存的場(chǎng)景，建議使用 獲取單個(gè)商品庫(kù)存 等更專業(yè)的庫(kù)存API。

Q：接口返回為空或錯(cuò)誤怎么辦？ A：首先檢查 errorCode 和 errorMsg。常見(jiàn)原因包括：商品ID無(wú)效、商品已刪除、access_token 失效或權(quán)限不足、調(diào)用頻率超限等。對(duì)照錯(cuò)誤碼排查問(wèn)題。

7. 總結(jié)

通過(guò) 獲取商品詳情 API，開(kāi)發(fā)者可以高效地根據(jù)商品ID獲取1688平臺(tái)上商品的豐富信息。合理利用此接口，可以構(gòu)建商品展示、比價(jià)、庫(kù)存監(jiān)控等多種應(yīng)用場(chǎng)景。調(diào)用時(shí)需嚴(yán)格遵守接口規(guī)范，關(guān)注授權(quán)、參數(shù)有效性及錯(cuò)誤處理。

建議：在正式集成前，務(wù)必仔細(xì)閱讀1688開(kāi)放平臺(tái)官方文檔中關(guān)于該接口的最新說(shuō)明，并利用API測(cè)試工具進(jìn)行調(diào)試。

?
審核編輯 黃宇