文档中心 > API类目 > 多媒体平台API

alibaba.tjb.picture.folder.create (淘特图片空间创建文件夹)

淘特图片空间创建文件夹

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
parent_folder_id Number 必须 0 父文件夹id。如果是传到根文件夹,该值为0。
folder_name String 必须 我是文件夹名 文件夹名称,最长50个字符,仅可输入中英文、数字及!@#%^&()-=_+.,~`特殊字符。

响应参数

名称 类型 示例值 描述
data TopCreateFolderDTO 创建文件夹的返回数据
  • └ folder_id
  • Number
  • 1234
  • 创建的文件夹id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaTjbPictureFolderCreateRequest req = new AlibabaTjbPictureFolderCreateRequest();
req.setParentFolderId(0L);
req.setFolderName("我是文件夹名");
AlibabaTjbPictureFolderCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_tjb_picture_folder_create_response>
    <data>
        <folder_id>1234</folder_id>
    </data>
</alibaba_tjb_picture_folder_create_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isp.remote-service-error 服务端处理异常 可能是服务不稳定,可稍后再试或联系服务提供方
isv.invalid-parameter 传入参数有误 请检查传入的参数格式,按照限定的格式传入
isv.createFolder-service-error:6004 当前用户可能同时在进行其他的创建文件夹、删除文件夹、编辑文件夹操作,对于同一个用户是不允许同时进行的 请稍后重试
isv.createFolder-service-error:6006 父文件夹不存在 检查父文件夹的id是否正确
isv.createFolder-service-error:6002 文件夹深度不能超过10层 用户删除层级过深的子文件夹后即可创建
isv.createFolder-service-error:6005 同一个用户文件夹数量不能超过1000个 用户删除文件夹后再重试
isv.createFolder-service-error:6001 同级文件夹名称重复 更换文件夹名称后重试
isv.createFolder-service-error:6024 如果父文件夹或者祖先文件夹正在进行异步删除,文件夹无法在其下创建。 重新选择父文件夹再创建

API工具

如何获得此API

FAQ

返回
顶部