使用Cloudinary时,您的所有图像、视频和其他原始文件都会上传到您的Cloudinar帐户。您可以使用我们的媒体库web界面浏览和管理您上传的媒体资产和生成的转换。此外,您可以使用Upload和Admin API中的方法,这些API提供了管理、组织和创建媒体资产的方法。
可以根据需要使用上传API方法。
管理API方法是速率受限的。
您可以在控制台设置的帐户页面中查看帐户计划允许的每小时管理员API请求数。
上载API
除了上传方法,此API还包括以下方法:
重命名和永久删除单个资产
向资产添加标记、上下文元数据和结构化元数据
创建新资产,如文本图像、档案(zip或tgz)和精灵
修改现有资产。
管理API
一个安全的API,具有管理和组织媒体资产的方法,包括:
列出和恢复资产
批量资产删除
管理上载预设、上载映射、转换和文件夹
更新现有资产
对帐户中的资产执行高级搜索
生成帐户使用情况报告
以及更多。。。
上传API示例-删除单个资产
以下Java示例使用Upload API destroy方法从Cloudinary帐户中删除带有公共ID示例的视频:
- Map config = ObjectUtils.asMap(
- "cloud_name", "my_cloud_name",
- "api_key", "my_api_key",
- "api_secret", "my_api_secret");
- Cloudinary cloudinary = new Cloudinary(config);
- Map result = cloudinary.uploader().destroy("sample",
- ObjectUtils.asMap("resource_type","video"));
示例输出:
- {
- "result": "ok"
- }
提示: 要删除多个资产,请使用Admin API deleteResources方法。
有关Java中的更多上传API示例,请选择上传API参考中的Java选项卡。
管理API示例-获取单个资产的详细信息
以下Java示例使用Admin API资源方法返回带有公共ID示例的图像的详细信息:
- Map config = ObjectUtils.asMap(
- "cloud_name", "my_cloud_name",
- "api_key", "my_api_key",
- "api_secret", "my_api_secret");
- Cloudinary cloudinary = new Cloudinary(config);
- Map result = cloudinary.api().resource("sample", ObjectUtils.emptyMap());
示例输出:
- {
- "asset_id": "d86882d7788f5d1d702cb63418f082a6",
- "public_id": "sample",
- "format": "jpg",
- "version": 1312461204,
- "resource_type": "image",
- "type": "upload",
- "created_at": "2017-08-04T12:33:24Z",
- "bytes": 120253,
- "width": 864,
- "height": 576,
- "url": "http://res.cloudinary.com/demo/image/upload/v1312461204/sample.jpg",
- "secure_url": "https://.../image/upload/v1312461204/sample.jpg",
- "next_cursor": "041a39fc10971b9eabd4993470f6bfaf",
- "derived": [
- {
- "transformation": "c_fill,w_100,h_100",
- "format": "jpg",
- "bytes": 7112,
- "id": "8267a869b62a93a59248f35d7f124c1f",
- "url": "http://.../demo/image/upload/c_fill,w_100,h_100/v1312461204/sample.jpg",
- "secure_url": "https://.../image/upload/c_fill,w_100,h_100/v1312461204/sample.jpg"
- },
- {
- "transformation": "w_230,h_168,c_fit",
- "format": "jpg",
- "bytes": 19173,
- "id": "383e22a57167445552a3cdc16f0a0c85",
- "url": "http://.../demo/image/upload/w_230,h_168,c_fit/v1312461204/sample.jpg",
- "secure_url": "https://.../image/upload/w_230,h_168,c_fit/v1312461204/sample.jpg"
- }
- ]
- }
有关Java中的更多管理API示例,请选择管理API参考中的Java选项卡。