跳转到内容
返回官网

创建文件夹

一、请求参数

创建文件夹。 创建文件夹存在如下的限制:

  1. 文件夹名称最多20个字符

  2. 每个文件夹下最多包含100个子文件夹

  3. 文件夹的最大层级为10层

  4. 一个父文件夹下的子文件夹不允许重名

  5. 累计创建的文件夹数量不能超过10万

请求URL:

POST https://kf.fw199.com/gateway/dd/material/createfolder

公共参数

参数名称参数类型是否必须示例值参数描述
appidString合作伙伴AppId
timestampString1657525936当前Unix时间戳,秒
seller_nickString38173182抖店的账号,对应蜂巢授权返回doudianseller字段
signString

业务参数

参数名称参数类型是否必须示例值参数描述
nameString商品图片素材文件夹名称。最多20字符
parent_folder_idString70036799713989921721250父文件夹id,根目录为0。不传该参数默认在根目录下创建文件夹
typeInt320文件夹类型。0-用户自建

二、请求示例代码

Java

请求示例代码

@Test
public void DDMaterialCreatefolder() throws Exception {
Map<String, Object> data = new HashMap<String, Object>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("seller_nick", Config.DDSellerNick);
data.put("name", "测试0521");
data.put("parent_folder_id", "0");
data.put("type", 0);
data.put("sign", Sign(data,Config.AppSecret));
// 调用服务API
String resp = doHttpRequest(Config.DDMaterialCreateFolder, data);
System.out.println(resp);
}

三、返回结果

{
"code": 0,
"message": "ok",
"data": {
"folder_id": "73713431646143613941425",
"is_new": true,
"name": "测试0521",
"parent_folder_id": "0",
"type": 0
}
}

说明: code为0表示成功,非0为失败,message会包含失败原因。返回字段说明见文档 https://op.jinritemai.com/docs/api-docs/69/946