淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
sales_type	String	可选	new_sign		1
sku_property_value_dtos	SkuPropertyValueDtos []	可选		最大列表长度：999999	1
└ property_key String 可选 product 1 └ value String 可选 21 1 └ property_name String 可选 smart 1
commodity_code	String	可选	be485		1
valid_from	String	可选	demo		1
promotion_id	String	可选	promotion12321		1
okki_order_product_id	String	可选	demo		1
client_id	String	可选	14350		1
ali_order_product_id	String	可选	demo		1
proposal_commodities	ProposalCommodities []	可选		最大列表长度：999999	1
sku_property_value_dtos SkuPropertyValueDtos [] 可选 1 └ property_key String 可选 product 1 └ value String 可选 2021lite 1 └ property_name String 可选产品 1 └ sales_type String 可选 new_sign 1 └ commodity_code String 可选 be606 1 └ source_promotion_id String 可选 promotion12321 1 └ total_price String 可选 3000 1 └ count String 可选 1 1 └ name String 可选橱窗 1 └ currency String 可选 CNY 1 └ type String 可选 BUY 1 └ reduction String 可选 0 1 └ sku_code String 可选 12321312321 1 └ source_promotion_name String 可选测试促销123 1
ali_cgs	String	可选	test_4116458941		1
promotion_name	String	可选	测试促销123		1
valid_to	String	可选	demo		1
currency	String	可选	CNY		1
expand_key	ExpandKey []	可选		最大列表长度：999999	1
└ value String 可选 value1示例 1 └ key String 可选 key1示例 1

名称	类型	示例值	描述
data	DataStruct []		1
cascade_options CascadeStruct 1 options OptionStruct [] 1 └ label String 赠送月数： 1 └ service_code String promotion_id_1_result_1 1 children ChildrenStruct [] 1 └ type String type 1 └ service_name String 赠送 1 └ show String 最高赠送3个月 1 └ unit_desc String 个月 1 └ disabled Boolean false 1 └ init_value String 2 1 └ cascade_code String be485 1 └ cascade_name String 深莞惠大区促销 1 └ init_value String 1 1 └ type String radio 1
error_desc	String	error	1
success	Boolean	true	1
resp_code	Number	0	1
status	Number	0	1

{"sku_property_value_dtos":[{"property_key":"product","value":"21","property_name":"smart"}],"commodity_code":"be485","sales_type":"new_sign","valid_from":"demo","promotion_id":"promotion12321","expand_key":[{"value":"value1示例","key":"key1示例"}],"okki_order_product_id":"demo","client_id":"14350","ali_order_product_id":"demo","proposal_commodities":[{"sku_property_value_dtos":[{"property_key":"product","value":"2021lite","property_name":"产品"}],"commodity_code":"be606","source_promotion_id":"promotion12321","sales_type":"new_sign","total_price":"3000","count":"1","name":"橱窗","currency":"CNY","type":"BUY","reduction":"0","sku_code":"12321312321","source_promotion_name":"测试促销123"}],"ali_cgs":"test_4116458941","promotion_name":"测试促销123","valid_to":"demo","currency":"CNY"}

{
    "data":[
        {
                "cascade_options":{
                    "options":[
                        {
                                "label":"赠送月数：",
                                "service_code":"promotion_id_1_result_1",
                                "children":[
                                    {
                                            "type":"type",
                                            "service_name":"赠送",
                                            "show":"最高赠送3个月",
                                            "unit_desc":"个月",
                                            "disabled":false,
                                            "init_value":"2"
                                    }
                                ]
                        }
                    ],
                    "cascade_code":"be485",
                    "cascade_name":"深莞惠大区促销",
                    "init_value":"1",
                    "type":"radio"
                }
        }
    ],
    "error_desc":"error",
    "success":true,
    "resp_code":0,
    "status":0
}

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

错误码	错误描述	解决方案
isp.http-read-timeout

错误码查询工具 SDK下载

开放平台

CRM猎户座前台

qimen.alibaba.saas.dynamic.cascade.form.get (奇门SAAS级联动态表单查询)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ