使用Schema文件发布一个产品

Schema体系发布一个产品

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/tmall/product/schema/add

参数名	类型	必须	示例值	说明
appid	String	true	uwkahf@jfs92	合作伙伴AppId
timestamp	String	true	1633618722	当前时间戳
tb_seller_nick	String	true	kingdo	淘宝卖家店铺登录账号，非店铺名称
sign	String	true	999de41d862efaa6f1084ead3b3ba480	如何计算生成见示例代码
category_id	Number	true	328818231125	商品发布的目标类目，必须是叶子类目
xml_data	Number	true	``	根据tmall.product.add.schema.get生成的产品发布规则入参数据
brand_id	Number	false	3232	品牌ID，可通过查询商家被授权品牌列表和类目列表接口获取

xml_data示例

<itemRule>
    <field id="prop_20000" name="品牌" type="singleCheck">
        <rules>
            <rule name="requiredRule" value="true"/>
        </rules>
            <value>222</value>

    </field>
    <field id="prop_13021751" name="货号" type="input">
        <rules>
            <rule name="requiredRule" value="true"/>
        </rules>
         <value>hh100</value>
    </field>
    <field id="prop_122216347" name="上市年份季节" type="singleCheck">
      <value>828914261</value>
    </field>
    <field id="prop_13328588" name="成分含量" type="singleCheck">
        <rules>
            <rule name="requiredRule" value="true"/>
        </rules>
          <value>145656297</value>
    </field>
    <field id="prop_122216586" name="服装版型" type="singleCheck">
        <rules>
            <rule name="requiredRule" value="true"/>
        </rules>

          <value>3267162</value>
    </field>
    <field id="prop_122216562" name="衣长" type="singleCheck">
        <rules>
            <rule name="requiredRule" value="true"/>
        </rules>
           <value>22561361</value>

    </field>
    <field id="prop_122216348" name="袖长" type="singleCheck">
        <rules>
            <rule name="requiredRule" value="true"/>
        </rules>
         <value>29444</value>

    </field>
    <field id="prop_20021" name="面料" type="singleCheck">
        <rules>
            <rule name="requiredRule" value="true"/>
        </rules>
          <value>105255</value>

    </field>
    <field id="product_images" name="产品图片" type="complex">
        <fields>
            <field id="product_image_0" name="产品图片" type="input">
                <rules>
                    <rule name="valueTypeRule" value="url"/>
                    <rule name="requiredRule" value="true"/>
                </rules>
                  <value>https://img.alicdn.com/imgextra/i2/661153176/TB2_4DUopuWBuNjSspnXXX1NVXa_!!661153176.jpg</value>

            </field>
            <field id="product_image_1" name="产品图片" type="input">
                <rules>
                    <rule name="valueTypeRule" value="url"/>
                </rules>
            </field>
            <field id="product_image_2" name="产品图片" type="input">
                <rules>
                    <rule name="valueTypeRule" value="url"/>
                </rules>
            </field>
            <field id="product_image_3" name="产品图片" type="input">
                <rules>
                    <rule name="valueTypeRule" value="url"/>
                </rules>
            </field>
            <field id="product_image_4" name="产品图片" type="input">
                <rules>
                    <rule name="valueTypeRule" value="url"/>
                </rules>
            </field>
        </fields>
    </field>
</itemRule>

二、请求示例代码

Java

@Test
   public void TmallProductSchemaAddRequestUrl() throws Exception {
        String tb_seller_nick = Config.TBSellerNick;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid", Config.AppId);
        data.put("tb_seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("category_id", "201241307");
//        data.put("brand_id", "10000497");
        String xmlData = "<itemRule>\n" +
                "    <field id=\"prop_20000\" name=\"品牌\" type=\"singleCheck\">\n" +
                "        <rules>\n" +
                "            <rule name=\"requiredRule\" value=\"true\"/>\n" +
                "        </rules>\n" +
                "            <value>222</value>\n" +
                "\n" +
                "    </field>\n" +
                "    <field id=\"prop_13021751\" name=\"货号\" type=\"input\">\n" +
                "        <rules>\n" +
                "            <rule name=\"requiredRule\" value=\"true\"/>\n" +
                "        </rules>\n" +
                "         <value>hh100</value>\n" +
                "    </field>\n" +
                "    <field id=\"prop_122216347\" name=\"上市年份季节\" type=\"singleCheck\">\n" +
                "      <value>828914261</value> \n" +
                "    </field>\n" +
                "    <field id=\"prop_13328588\" name=\"成分含量\" type=\"singleCheck\">\n" +
                "        <rules>\n" +
                "            <rule name=\"requiredRule\" value=\"true\"/>\n" +
                "        </rules> \n" +
                "          <value>145656297</value>\n" +
                "    </field>\n" +
                "    <field id=\"prop_122216586\" name=\"服装版型\" type=\"singleCheck\">\n" +
                "        <rules>\n" +
                "            <rule name=\"requiredRule\" value=\"true\"/>\n" +
                "        </rules>\n" +
                "  \n" +
                "          <value>3267162</value>\n" +
                "    </field>\n" +
                "    <field id=\"prop_122216562\" name=\"衣长\" type=\"singleCheck\">\n" +
                "        <rules>\n" +
                "            <rule name=\"requiredRule\" value=\"true\"/>\n" +
                "        </rules>\n" +
                "           <value>22561361</value>\n" +
                "       \n" +
                "    </field>\n" +
                "    <field id=\"prop_122216348\" name=\"袖长\" type=\"singleCheck\">\n" +
                "        <rules>\n" +
                "            <rule name=\"requiredRule\" value=\"true\"/>\n" +
                "        </rules>\n" +
                "         <value>29444</value>\n" +
                "    \n" +
                "    </field>\n" +
                "    <field id=\"prop_20021\" name=\"面料\" type=\"singleCheck\">\n" +
                "        <rules>\n" +
                "            <rule name=\"requiredRule\" value=\"true\"/>\n" +
                "        </rules>\n" +
                "          <value>105255</value>\n" +
                "        \n" +
                "    </field>\n" +
                "    <field id=\"product_images\" name=\"产品图片\" type=\"complex\">\n" +
                "        <fields>\n" +
                "            <field id=\"product_image_0\" name=\"产品图片\" type=\"input\">\n" +
                "                <rules>\n" +
                "                    <rule name=\"valueTypeRule\" value=\"url\"/>\n" +
                "                    <rule name=\"requiredRule\" value=\"true\"/>\n" +
                "                </rules> \n" +
                "                  <value>https://img.alicdn.com/imgextra/i2/661153176/TB2_4DUopuWBuNjSspnXXX1NVXa_!!661153176.jpg</value>\n" +
                "\n" +
                "            </field>\n" +
                "            <field id=\"product_image_1\" name=\"产品图片\" type=\"input\">\n" +
                "                <rules>\n" +
                "                    <rule name=\"valueTypeRule\" value=\"url\"/>\n" +
                "                </rules>\n" +
                "            </field>\n" +
                "            <field id=\"product_image_2\" name=\"产品图片\" type=\"input\">\n" +
                "                <rules>\n" +
                "                    <rule name=\"valueTypeRule\" value=\"url\"/>\n" +
                "                </rules>\n" +
                "            </field>\n" +
                "            <field id=\"product_image_3\" name=\"产品图片\" type=\"input\">\n" +
                "                <rules>\n" +
                "                    <rule name=\"valueTypeRule\" value=\"url\"/>\n" +
                "                </rules>\n" +
                "            </field>\n" +
                "            <field id=\"product_image_4\" name=\"产品图片\" type=\"input\">\n" +
                "                <rules>\n" +
                "                    <rule name=\"valueTypeRule\" value=\"url\"/>\n" +
                "                </rules>\n" +
                "            </field>\n" +
                "        </fields>\n" +
                "    </field>\n" +
                "</itemRule>";
        data.put("xml_data", xmlData);
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        // 调用服务API
        String rsp =   doHttpRequest(Config.TmallProductSchemaAddRequestUrl, data);
        // 需要进行编码转换，比如 "\u003c" 转成  "<"   ，  "\u003e" 转成 ">" 等
        String unescapeRsp = StringEscapeUtils.unescapeJavaScript(rsp);
        System.out.println(unescapeRsp);
    }

三、返回结果

返回结果如下

{
    "code":0,
    "message":"ok",
    "data":{
        "add_product_result":"<itemrule> <field id=\"product_id\" name=\"产品ID\" type=\"input \">1221<\/field> <field id=\"create_time\" name=\"创建时间\" type=\"input \">2014-01-01 00:00:00<\/field> <itemrule>",
        "request_id":"zyqf3xu5bnem"
    },
    "trace_id":""
}

说明： code为0表示成功，非0为失败，message会包含失败原因， add_product_result为新发产品结果。