淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	描述
itemId	Number	必须	0	饰品类目ID
limit	Number	可选	1	每页显示数
maxWear	String	可选	1	最大磨损
minWear	String	可选	1	最小磨损
page	Number	可选	1	页码
paintIndex	Number	可选	1	皮肤编号
paintSeed	String	可选	1	图案模板
containSticker	String	可选	1	是否带印花 1带印花 2不带印花
stickerIds	String	可选	1	印花ID列表
slotStickerIds	String	可选	1	带印花位的印花ID列表
sort	Number	可选	1	排序
minPrice	String	可选	1	最低价
maxPrice	String	可选	1	最高价

名称	类型	示例值	描述
bizErrorData	String	xxx	错误信息
data	Data		业务数据
└ total Number 20 商品总数 └ pages Number 2 总页数 └ limit Number 10 每页显示数 └ page Number 1 页码 list DataList [] 列表数据 └ delivery Number 0 发货方式 └ originalPrice String 0 成本价 └ inspectImageThumb String 123 缩略图 subsidyTag SubsidyTag 补贴标签 └ tagId String CONSUME_SUBSIDY 补贴ID └ tag String 千万补贴补贴文案 └ inspectImageUrl String 123 图片地址 itemInfo ItemInfo 商品详情 └ rarityName String xxx 品质名称 └ exteriorName String xxx 外观名称 └ exteriorColor String xxx 外观颜色 └ qualityName String xxx 类别名称 └ exterior String xxx 外观标识 └ typeName String xxx 类型名称 └ rarityColor String xxx 品质颜色 └ qualityColor String xxx 类别颜色 └ type String xxx 类型标识 └ quality String xxx 类别标识 └ rarity String xxx 品质标识 └ subsidyAmount String 100 补贴金额 └ itemId String 123 饰品类目ID └ subsidyPrice String 1.0 补贴价格 └ inspect3dUrl String xxx 3d检视图地址 └ price String 0 价格 └ appId String 730 游戏ID └ imageUrl String xxx 图片地址 └ inspect3dViewable Number 0 3d检视图是否可检视 └ name String xxx 名称 └ inspectViewable Number 0 2d检视图是否可检视 └ id String 123 商品ID assetInfo AssetInfo 商品属性 └ ext String xxx 拓展信息 └ paintSeed String 0 图案模板 └ fadeColor String xxx 渐变颜色 └ gradient Number 0 渐变度 └ wear String 0 磨损度 └ levelName String xxx 民间分类名称 └ fraudwarning String xxx 改名标签 └ classId String 0 classiD └ instanceId String 0 INSTANCEid └ levelColor String xxx 民间分类颜色 └ assetId String 0 饰品唯一标识 └ paintIndex String 0 皮肤编号 └ styleId String 0 最高款式ID或民间分类ID stickers Stickers [] 印花列表 └ stickerId String 1 印花ID └ type String 1 类型 └ slot String 1 印花槽位 └ id String 1 印花或布章iD └ wear String 1 磨损度 └ name String 1 名称 └ imageUrl String 1 图片地址 └ price String 1 价格 └ itemId String 1 印花类目ID
bizErrorMsg	String	xxx	错误信息
success	Boolean	true	调用结果
bizErrorCode	Number	0	错误码

{"paintSeed":"1","stickerIds":"1","sort":1,"itemId":0,"maxWear":"1","paintIndex":1,"containSticker":"1","minPrice":"1","limit":1,"slotStickerIds":"1","minWear":"1","page":1,"maxPrice":"1"}

{
    "bizErrorData":"xxx",
    "data":{
        "total":20,
        "pages":2,
        "limit":10,
        "page":1,
        "list":[
            {
                    "delivery":0,
                    "originalPrice":"0",
                    "inspectImageThumb":"123",
                    "subsidyTag":{
                        "tagId":"CONSUME_SUBSIDY",
                        "tag":"千万补贴"
                    },
                    "inspectImageUrl":"123",
                    "itemInfo":{
                        "rarityName":"xxx",
                        "exteriorName":"xxx",
                        "exteriorColor":"xxx",
                        "qualityName":"xxx",
                        "exterior":"xxx",
                        "typeName":"xxx",
                        "rarityColor":"xxx",
                        "qualityColor":"xxx",
                        "type":"xxx",
                        "quality":"xxx",
                        "rarity":"xxx"
                    },
                    "subsidyAmount":"100",
                    "itemId":"123",
                    "subsidyPrice":"1.0",
                    "inspect3dUrl":"xxx",
                    "price":"0",
                    "appId":"730",
                    "imageUrl":"xxx",
                    "inspect3dViewable":0,
                    "name":"xxx",
                    "inspectViewable":0,
                    "id":"123",
                    "assetInfo":{
                        "ext":"xxx",
                        "paintSeed":"0",
                        "fadeColor":"xxx",
                        "gradient":0,
                        "wear":"0",
                        "levelName":"xxx",
                        "fraudwarning":"xxx",
                        "classId":"0",
                        "instanceId":"0",
                        "levelColor":"xxx",
                        "assetId":"0",
                        "paintIndex":"0",
                        "styleId":"0",
                        "stickers":[
                            {
                                    "stickerId":"1",
                                    "type":"1",
                                    "slot":"1",
                                    "id":"1",
                                    "wear":"1",
                                    "name":"1",
                                    "imageUrl":"1",
                                    "price":"1",
                                    "itemId":"1"
                            }
                        ]
                    }
            }
        ]
    },
    "bizErrorMsg":"xxx",
    "success":true,
    "bizErrorCode":0
}

{"bizErrorMsg":"Illegal request","success":"不等于true","bizErrorCode":"sign-check-failure"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

交易猫API

qimen.alibaba.jiaoyimao.steam.spu.list (饰品SPU商品列表)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ