创建文件夹
一、请求参数
创建文件夹。 创建文件夹存在如下的限制:
-
文件夹名称最多20个字符
-
每个文件夹下最多包含100个子文件夹
-
文件夹的最大层级为10层
-
一个父文件夹下的子文件夹不允许重名
-
累计创建的文件夹数量不能超过10万
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| 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-用户自建 |
二、请求示例代码
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