创建文件夹

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

  1. 文件夹名称最多20个字符
  2. 每个文件夹下最多包含100个子文件夹
  3. 文件夹的最大层级为10层
  4. 一个父文件夹下的子文件夹不允许重名
  5. 累计创建的文件夹数量不能超过10万

请求URL:

POST https://kf.fw199.com/gateway/dd/material/create/folder

公共参数

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

业务参数

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

2. 请求示例代码(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);
    }

3. 返回结果如下:


{
    "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

文档更新时间: 2024-05-21 14:57   作者:JSL