速卖通商品详情API接口 (JSON返回)

速卖通(AliExpress)提供了多种API接口来获取商品详情信息。以下是关于商品详情API的主要信息：

1. 商品详情获取API

接口名称

aliexpress.affiliate.product.detail.get (联盟API) 或 api.getProductDetail (开放平台API)

请求方式

通常为HTTP GET或POST请求

请求参数示例

json{"app_key": "您的应用KEY","sign": "签名","product_id": "商品ID","target_currency": "USD","target_language": "EN","fields": "title,price,images,description"}

成功响应示例

json{"resp_result": {"resp_code": 200,"resp_msg": "success"},"product_id": "123456789","title": "Example Product Title","description": "Detailed product description...","current_price": "19.99","original_price": "29.99","currency": "USD","images": ["https://ae01.alicdn.com/kf/HTB1.jpg","https://ae01.alicdn.com/kf/HTB2.jpg"],"sale_count": 1500,"evaluate_score": "4.8","shop_url": "https://www.aliexpress.com/store/123456","variants": [{"sku_id": "123","properties": "Color:Red;Size:M","price": "19.99","inventory": 100}],"freight": {"type": "free","estimate_delivery": "7-15 days"}}

2. 速卖通开放平台商品API

商品详情接口

/api/v1/product/get

请求参数

json{"productId": "商品ID","locale": "en_US","currency": "USD"}

响应数据结构

json{"code": "SUCCESS","data": {"productId": "123456789","subject": "Product Title","detail": "HTML格式的产品详情","aeopNationalQuoteConfiguration": {"bulkDiscount": "5% off on orders over $100"},"imageURLs": "https://ae01.alicdn.com/kf/HTB1.jpg,https://ae01.alicdn.com/kf/HTB2.jpg","deliveryOptions": [{"name": "Standard Shipping","price": "0.00","shippingTime": "15-30 days"}],"skuInfos": [{"skuId": "123","skuPrice": "19.99","skuStock": true,"properties": [{"propertyValueId": "100","propertyName": "Color","propertyValueName": "Red"}]}]}}

3. 使用注意事项

1. 认证：需要API密钥或OAuth2.0认证

2. 速率限制：通常有每分钟/每小时调用次数限制

3. 字段选择：可以通过fields参数指定返回的字段以减少数据量

4. 多语言支持：可通过locale参数获取不同语言的商品信息

5. 货币转换：可通过target_currency参数指定返回价格的货币类型

4. 官方文档参考

• 速卖通联盟API文档

• 速卖通开放平台文档

5. 示例代码(Python)

python
import requests
import hashlib

def get_product_detail(api_key, api_secret, product_id):
base_url = "https://api.aliexpress.com/api/v1/product/get"
params = {
"productId": product_id,
"locale": "en_US",
"currency": "USD",
"app_key": api_key,
"timestamp": "当前时间戳"
}

# 生成签名
sign_str = api_secret + ''.join([f"{k}{v}" for k, v in sorted(params.items())])
params['sign'] = hashlib.md5(sign_str.encode()).hexdigest().upper()

response = requests.get(base_url, params=params)
return response.json()

# 使用示例
product_data = get_product_detail("your_api_key", "your_api_secret", "123456789")
print(product_data)

请注意，实际API接口和参数可能会随时间变化，建议直接参考速卖通官方开发者文档获取最新信息。