商品发布 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 - 最外层
code为0表示蜂巢调用成功;非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