商品发布 schema 渲染

抖店商品发布 schema 渲染,根据商品ID获取商品的schema

一、接口名称

  • 接口名称:
  • 接口地址:https://kf.fw199.com/gateway/dd/product/getschema
  • 请求方式:POST
  • Content-Type:application/x-www-form-urlencoded

二、请求参数

公共参数

参数名 类型 是否必需 说明
appid string 必需 开发者 appid
timestamp string 必需 时间戳(
sign string 必需 参数签名,算法见 蜂巢开放平台开发指南

业务参数

参数名 类型 是否必需 示例值 说明
seller_nick string 必需 158458425 抖店店铺标识(上货云授权后的 shop_id)
sysid string 必需 207 应用标识, 请联系客服
category_id number 31860 类目 Id
product_id number 1232 商品 Id
spu_id number 1232 SPU id
model string {} schema 数据,JSON 字符串

三、请求示例代码(Java)

@Test
public void ddProductGetSchema() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/dd/product/getschema";
    String sellerNick = "158458425";

    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));
    data.put("seller_nick", sellerNick);
    data.put("sysid", "xxxx");
    data.put("product_id ", "xxxxx");

    data.put("sign", Utils.Sign(data, Config.AppSecret));

    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

四、返回结果

说明:

  • HTTP 状态码始终为 200,业务成败看 JSON 中的 code
  • 最外层 code0 表示蜂巢调用成功;非 0 为失败,message 含失败原因
  • 成功时 data 为抖店 /product/getSchema 的业务结果(结构以官方为准)

4.1 成功示例

{
    "code": 0,
    "data": {
        "model": "省略...",
        "product_data": {
            "check_status": 7,
            "draft_status": 0,
            "status": 1
        }
    },
    "message": "success"
}

4.2 data 字段说明

参数名称 参数类型 字段标签 示例值 参数描述
model String {} schema 数据、json 格式
product_data Struct - 商品数据
status Number 3 商品在店铺中状态:0-在线;1-下线;2-删除;详见商品状态机:https://op.jinritemai.com/docs/question-docs/92/2070
check_status Number 3 商品审核状态:1-未提交;2-待审核;3-审核通过;4-审核未通过;5-封禁;7-审核通过待上架;详见商品状态机:https://op.jinritemai.com/docs/question-docs/92/2070
draft_status Number 0 草稿状态:0-无草稿;1-未提审;2-待审核;3-审核通过;4-审核未通过。详见:https://op.jinritemai.com/docs/question-docs/92/2070
文档更新时间: 2026-08-25 17:32   作者:admin