首先我们要明白一个概念,商品详情和商品主图是不一样的,商品详情是你要上架的产品的一些信息,包括:标题、属性、价格、图片、描述等等。
那么在这个过程中就需要使用 API接口获取到这些信息。
API接口:是一个 JavaScript库,它可以让你访问系统中已有的各种资源,如网页、数据库、邮件等等。目前在很多企业系统中都已经采用了 API接口技术,而我们需要了解 API接口的定义和特点,以便更好地使用 API接口技术。
公共参数
名称 类型 必须 描述
key String 是 调用key(必须以GET方式拼接在URL中)
secret String 是 调用密钥(more接口-v;18870288846
api_name String 是 API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cache String 否 [yes,no]默认yes,将调用缓存的数据,速度比较快
result_type String 否 [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
lang String 否 [cn,en,ru]翻译语言,默认cn简体中文
version String 否 API版本
请求参数
请求参数:num_iid=60840463360
参数说明:num_iid:商品ID
响应参数
Version: Date:
名称 类型 必须 示例值 描述
num_iid
Bigint 0 60840463360 商品ID
title
String 0 穿上灰色男士日常都市步行鞋 商品标题
desc_short
String 0 获取调用key和密钥 商品简介
price
String 0 47.70 价格
nick
String 0 cn1522808546pkux 掌柜昵称
num
String 0 999
min_num
String 0 2
detail_url
String 0 https://www.alibaba.com/product-detail/Reebaby-Hot-Sell-Group-0-with_60840463360.html 商品链接
pic_url
String 0 //sc01.alicdn.com/kf/HTB1GHVXaPvuK1Rjy0Faq6x2aVXa7.jpg 商品图片
desc
String 0
item_imgs
Mix 0 [{"url": "//sc02.alicdn.com/kf/HTB1ta_basfrK1RjSszcq6xGGFXaA/China-Factory-Outdoor-Driving-Casual-Shoes-Men.jpg"}] 商品图片列表
props_name
String 0 "191288010:-1:颜色:海军;191288010:3331185:颜色:白色; 商品属性名
prop_imgs
Mix 0 {"prop_img": ["properties": "191288010:3851110","url": "//sc01.alicdn.com/kf/HTB1CnsUasfrK1Rjy1Xdq6yemFXag.jpg_250x250.jpg"]} 商品属性图片列表
props
Mix 0 {"name": "产地","value": "中国"} 属性
skus
Mix 0 {sku [[]]} 商品规格信息列表
priceRange
Mix 0 [2,47.7] 价格区间
props_list
Mix 0 ["191288010:-1": "颜色:海军"] 商品属性列表
seller_info
Mix 0 {"nick": "cn1522808546pkux", "title": "Guangzhou Gull Road Trade Co., Ltd.", "zhuy": "https://hotpotato.en.alibaba.com/", "shop_name": "Guangzhou Gull Road Trade Co., Ltd." } 卖家信息
error
String 0 错误信息
props_img
Mix 0 ["191288010:3851110": "//sc01.alicdn.com/kf/HTB1CnsUasfrK1Rjy1Xdq6yemFXag.jpg_250x250.jpg"]
currency_code
String 0 USD
language_code
String 0 en
property_alias
String 0 商品属性别名
sales
String 0 销量
desc_img
Mix 0 ["//u.alicdn.com/js/5v/esite/img/img-placeholder.png"] 详情图片
shop_item
Mix 0 []
relate_items
Mix 0 []
Python请求示例
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://v-x-;PNG_WNMN/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=60840463360"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
错误码解释
状态代码(error_code) 状态信息 详细描述 是否收费
0000 success 接口调用成功并返回相关数据 是
2000 Search success but no result 接口访问成功,但是搜索没有结果 是
4000 Server internal error 服务器内部错误 否
4001 Network error 网络错误 否
4002 Target server error 目标服务器错误 否
4003 Param error 用户输入参数错误 忽略
4004 Account not found 用户帐号不存在 忽略
4005 Invalid authentication credentials 授权失败 忽略
4006 API stopped 您的当前API已停用 忽略
4007 Account stopped 您的账户已停用 忽略
4008 API rate limit exceeded 并发已达上限 忽略
4009 API maintenance API维护中 忽略
4010 API not found with these values API不存在 忽略
4012 Please add api first 请先添加api 忽略
4013 Number of calls exceeded 调用次数超限 忽略
4014 Missing url param 参数缺失 忽略
4015 Wrong pageToken 参数pageToken有误 忽略
4016 Insufficient balance 余额不足 忽略
4017 timeout error 请求超时 否
5000 unknown error 未知错误 否
文章内容有限,欢迎私信沟通交流。