淘宝开放平台 - 文档中心

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
sellIds	Number []	必须	1	最大列表长度：100	在售ID列表

名称	类型	示例值	描述
data	Data []		Business data
└ delivery Number 0 发货方式 └ inspectImageThumb String xxx 渐视图缩略图 └ paintType Number 0 皮肤类型,民间分类的决定因素:0:不显示; 1:由皮肤编号，即paintIndex决定;2:由图案模板决定，即由paintSeed决定 itemInfo ItemInfo 饰品标签属性 └ itemSetName String xxx 收藏品名称 └ rarityName String xxx dota稀有度名称; csgo品质名称 └ exteriorColor String xxx 外观颜色 └ patchCapsule String xxx 布章收藏器 └ exterior String xxx 外观 └ typeName String xxx 类型名称 └ rarityColor String xxx dota稀有度颜色; csgo品质颜色 └ qualityColor String xxx dota品质颜色; csgo类别颜色 └ weaponName String xxx 武器名称 └ type String xxx 类型 └ itemSet String xxx 收藏品 └ customPlayerName String xxx 探员名称 └ quality String xxx dota品质; csto类别 └ weapon String xxx 武器 └ exteriorName String xxx 外观名称 └ qualityName String xxx dota品质名称; csgo类别名称 └ stickerCapsuleName String xxx 印花收藏器名称 └ customPlayer String xxx 探员 └ patchCapsuleName String xxx 布章收藏器名称 └ stickerCapsule String xxx 印花收藏器 └ rarity String xxx dota稀有度; csgo品质 └ saleStatus Number 0 库存状态 └ systemTime Number 0 当前系统时间 └ token String xxx 库存token └ itemId Number 0 饰品类目ID └ tradableTime Number 0 可交易时间 └ inspect3dUrl String xxx 3D检视图地址 └ marketShortName String xxx 市场短名称 └ price String 0 在售价 └ appId Number 0 游戏ID └ imageUrl String xxx 饰品图片 └ name String xxx 饰品名称 └ tradable Number 0 是否可交易 └ inspectViewable Number 0 是否可检视 └ marketHashName String xxx 市场标识名称 └ shortName String xxx 饰品短名称 assetInfo AssetInfo 饰品属性 └ ext String xxx 扩展数据 └ paintSeed Number 0 图案模板 └ fadeColor String xxx 渐变颜色 └ gradient Number 0 渐变度 └ inspectImageUrl String xxx 检视图地址 └ wear String 0 印花磨损度 └ levelName String xxx 民间分类名称 └ fraudwarning String xxx 改名标签 └ classId Number 0 classId └ instanceId Number 0 instanceId └ levelColor String xxx 民间分类颜色 └ assetId Number 0 饰品唯一标识 └ paintIndex Number 0 皮肤编号 └ styleId Number 0 最高款式ID或民间分类ID stickers Stickers [] 印花列表 └ itemId Number 0 印花类目ID └ price String 0 印花在售价 └ imageUrl String xxx 印花图片 └ name String xxx 印花名称 └ wear String 0 印花磨损度 └ id Number 0 印花或布章ID └ slot Number 0 印花槽位 └ type Number 0 类型:2:布章;其他为印花 └ stickerId Number 0 steam的印花ID └ inspectImage String xxx 检视图地址 └ originalPrice String 0 成本价 └ subsidyPrice String 1.0 补贴价格 subsidy Subsidy 用户补贴 subsidyTag SubsidyTag 补贴标签 └ tag String 千万补贴标签内容 └ tagId String CONSUME_SUBSIDY 标签标识,如千万补贴为 CONSUME_SUBSIDY └ subsidyAmount String 100 补贴金额 └ maxThreshold String 100 补贴最大金额 └ eligibility Number 1 补贴资格:1:有资格 0无资格 └ sellerId String 1 卖家id
success	Boolean	true	Is request successful
bizErrorCode	Number	0	Error code
bizErrorData	String	xxx	Error data,when errorCode is not equals to 0,maybe this property will have a value
bizErrorMsg	String	xxx	Error message

{"sellIds":[1]}

{
    "data":[
        {
                "delivery":0,
                "inspectImageThumb":"xxx",
                "paintType":0,
                "itemInfo":{
                    "itemSetName":"xxx",
                    "rarityName":"xxx",
                    "exteriorColor":"xxx",
                    "patchCapsule":"xxx",
                    "exterior":"xxx",
                    "typeName":"xxx",
                    "rarityColor":"xxx",
                    "qualityColor":"xxx",
                    "weaponName":"xxx",
                    "type":"xxx",
                    "itemSet":"xxx",
                    "customPlayerName":"xxx",
                    "quality":"xxx",
                    "weapon":"xxx",
                    "exteriorName":"xxx",
                    "qualityName":"xxx",
                    "stickerCapsuleName":"xxx",
                    "customPlayer":"xxx",
                    "patchCapsuleName":"xxx",
                    "stickerCapsule":"xxx",
                    "rarity":"xxx"
                },
                "saleStatus":0,
                "systemTime":0,
                "token":"xxx",
                "itemId":0,
                "tradableTime":0,
                "inspect3dUrl":"xxx",
                "marketShortName":"xxx",
                "price":"0",
                "appId":0,
                "imageUrl":"xxx",
                "name":"xxx",
                "tradable":0,
                "inspectViewable":0,
                "marketHashName":"xxx",
                "shortName":"xxx",
                "assetInfo":{
                    "ext":"xxx",
                    "paintSeed":0,
                    "fadeColor":"xxx",
                    "gradient":0,
                    "inspectImageUrl":"xxx",
                    "wear":"0",
                    "levelName":"xxx",
                    "fraudwarning":"xxx",
                    "classId":0,
                    "instanceId":0,
                    "levelColor":"xxx",
                    "assetId":0,
                    "paintIndex":0,
                    "styleId":0,
                    "stickers":[
                        {
                                "itemId":0,
                                "price":"0",
                                "imageUrl":"xxx",
                                "name":"xxx",
                                "wear":"0",
                                "id":0,
                                "slot":0,
                                "type":0,
                                "stickerId":0
                        }
                    ]
                },
                "inspectImage":"xxx",
                "originalPrice":"0",
                "subsidyPrice":"1.0",
                "subsidy":{
                    "subsidyTag":{
                        "tag":"千万补贴",
                        "tagId":"CONSUME_SUBSIDY"
                    },
                    "subsidyAmount":"100",
                    "maxThreshold":"100",
                    "eligibility":1
                },
                "sellerId":"1"
        }
    ],
    "success":true,
    "bizErrorCode":0,
    "bizErrorData":"xxx",
    "bizErrorMsg":"xxx"
}

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

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

交易猫API

qimen.alibaba.jiaoyimao.steam.item.details (批量查询)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ