淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
commodity_code	String	可选	be485		1
ali_cgs	String	可选	test_4116458941		1
promotion_name	String	可选	测试促销123		1
promotion_id	String	可选	promotion12321		1
expand_key	ExpandKey []	可选		最大列表长度：999999	1
└ key String 可选 key1示例 1 └ value String 可选 value1示例 1
client_id	String	可选	14350		1
proposal_commodities	ProposalCommodities []	可选		最大列表长度：100	其余购买商品信息
sku_property_value_dtos SkuPropertyValueDtos [] 可选商品属性 └ property_key String 可选 product 属性key └ property_name String 可选产品属性名称 └ value String 可选 2021lite 属性值 └ reduction String 可选 0 减免金额 └ total_price String 可选 3000 总金额 └ type String 可选 1 类型 └ currency String 可选 CNY 币种 └ name String 可选 OKKI Shops专业版商品名称 └ count String 可选 1 数量 └ sku_code String 可选 123331 skuCode └ source_promotion_name String 可选测试促销促销名称 └ source_promotion_id String 可选 12321 促销id └ commodity_code String 可选 bp017 商品code └ sales_type String 可选 new_sign 售卖属性

名称	类型	示例值	描述
data	Data []		1
tab_content TabContent 1 options OptionsOne [] 1 └ ali_order_product_id String demo 11 └ ali_order_no String demo 1 └ product_id String 19 1 └ valid_to String demo 1 └ okki_order_product_id String demo 11 options OptionsTwo [] 1 └ service_name String 年限 11 └ show String 24000.00 / 10账号 / 年 1 options OptionsThree [] 1 └ label String 1年 1 └ value String 1 1 └ service_code String buy_duration 1 └ type String radio 1 └ init_value String 1 1 └ unit_desc String ss 1 └ must_choice Boolean true 1 └ valid_from String demo 1 └ label String Smart 1 └ value String Smart 1 └ product_name String OKKI SMART管理软件V1.0 1 └ product_amount String 24000.00 1 └ label String 产品型号 1 └ type String tab 1 └ tab_name String 新续签 1 └ tab_key String new_sign 1 └ tab_msg String 客户不满足条件 1
error_desc	String	ss	1
success	Boolean	true	1
resp_code	Number	0	1
status	Number	0	1

{"proposal_commodities":[{"sku_property_value_dtos":[{"property_key":"product","value":"2021lite","property_name":"产品"}],"source_promotion_id":"12321","commodity_code":"bp017","sales_type":"new_sign","total_price":"3000","name":"OKKI Shops专业版","count":"1","currency":"CNY","reduction":"0","type":"1","sku_code":"123331","source_promotion_name":"测试促销"}],"commodity_code":"be485","ali_cgs":"test_4116458941","promotion_name":"测试促销123","promotion_id":"promotion12321","expand_key":[{"value":"value1示例","key":"key1示例"}],"client_id":"14350"}

{
    "data":[
        {
                "tab_content":{
                    "options":[
                        {
                                "ali_order_product_id":"demo",
                                "ali_order_no":"demo",
                                "product_id":"19",
                                "valid_to":"demo",
                                "okki_order_product_id":"demo",
                                "options":[
                                    {
                                            "service_name":"年限",
                                            "show":"24000.00 \/ 10账号 \/ 年",
                                            "options":[
                                                {
                                                        "label":"1年",
                                                        "value":"1"
                                                }
                                            ],
                                            "service_code":"buy_duration",
                                            "type":"radio",
                                            "init_value":"1",
                                            "unit_desc":"ss",
                                            "must_choice":true
                                    }
                                ],
                                "valid_from":"demo",
                                "label":"Smart",
                                "value":"Smart",
                                "product_name":"OKKI SMART管理软件V1.0",
                                "product_amount":"24000.00"
                        }
                    ],
                    "label":"产品型号",
                    "type":"tab"
                },
                "tab_name":"新续签",
                "tab_key":"new_sign",
                "tab_msg":"客户不满足条件"
        }
    ],
    "error_desc":"ss",
    "success":true,
    "resp_code":0,
    "status":0
}

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

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

CRM猎户座前台

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

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ