不同的在线服务、网站和移动应用对图像管理的要求大相径庭图像管理管道归结为同一种基本公式-上传图像、规范化图像、存储图像并变换衍生物(thumbnails、effects、waps等)。准备发送并保证用户浏览网站或使用手机应用时快速高效访问
币游国际真人娱乐开始建云平台时, 我们设想平台可以精简在线服务 全部资产管理管道需求币游国际真人娱乐并使用客户集成库简单化多维平台编程语言币游国际真人娱乐欢乐地看到我们每位客户 发现新方式使用平台 并用不同的API调用解决假想
网络应用正常流中 完全有效或浏览用户上传图片, 查找特定图像,删除图像,删除变换等万一你试云化 你可能知道用得上
管理控制台手动完成这些任务但正如许多客户告诉我们并频繁请求的那样,有时需要比目前人工实现更多控件
币游国际真人娱乐今日,我们又迈出了重要的一步 使云平台更可定制
无需多言,我们想欢迎云情新强
行政API直觉重置HTTPAPAPi 程序化管理您的云托管全部资产
建设API时,我们尽力覆盖所有常见管理任务
- 列出所有上传图片和原始文件
- 接收细节和元数据上传图像,包括时标、格式、维度等
- 列表上传图像导出
- 查找共享标签的所有图像
- 列表所有变换
- 列标签
- 接收变换细节
- 创建命名变换
- 更新现有变换
- 删除图像、原始文件、衍生图像和变换
API使用HTTPS端点访问如下格式:
https://api.www.agrosoland.com/v1_1/:cloud_name/:action
资源列表
币游平台网页版官方https://api.www.agrosoland.com/v1_1/demo/resources/images
验证使用完成
基础认证安全HTTP云语
API密钥并
API保密用于验证 。
请求参数附到 URL响应简单化
JSON系统片段和RESTAPI一样,只读请求用HTTPGET发送,而写请求用PUT、POST和DELETE发送
更多细节检查
文档页面.
客户库为基于 URLAPI提供易用打包程序,使用本地编程语言选择请求构建认证自动完成 JSON响应解析并返回
下图
鲁比示例列表所有云托管图像
币游平台网页版官方$ result = Cloudinary::Api.resources => {"resources"=> [{"public_id"=>"sample1", "format"=>"png", "version"=>1349196740, "resource_type"=>"image", "type"=>"upload", "created_at"=>"2012-10-02T16:52:20Z", "bytes"=>71376, "width"=>261, "height"=>253, "url"=> "https://res.www.agrosoland.com/sam/image/upload/v1349196740/sample1.png", "secure_url"=> "https://d3jpl91pxevbkh.cloudfront.net/sam/image/upload/v1349196740/sample1.png"}, {"public_id"=>"sample2", "format"=>"png", "version"=>1349196732, "resource_type"=>"image", "type"=>"upload", "created_at"=>"2012-10-02T16:52:12Z", "bytes"=>133171, "width"=>278, "height"=>432, "url"=> "https://res.www.agrosoland.com/sam/image/upload/v1349196732/sample2.png", "secure_url"=> "https://d3jpl91pxevbkh.cloudfront.net/sam/image/upload/v1349196732/sample2.png"}, ...下游9691E7
上下举个例子
PHP:
需要Cloudiary.ph需要api.ph$api=新云化Api币游平台网页版官方$BLED=$api->Resources ();
ython语言:
币游平台网页版官方导入云性.api结果=云性.api.resources
并
节点js:
Var云性=需求币游平台网页版官方云性.api资源 {函数/结果/{主控台.log/结果/}
默认时, 单请求返回 10 项结果 。可指定
最大结果参数如果单请求更多结果可同时使用
ext_cror参数穿透所有资产
下一个例子显示如何获取单上传图像的全部细节, 包括图片衍生图列表 :
$ result = Cloudinary::Api.resource("sample1") => {"public_id"=>"sample1", "format"=>"png", "version"=>1349196740, "resource_type"=>"image", "type"=>"upload", "created_at"=>"2012-10-02T16:52:20Z", "bytes"=>71376, "width"=>261, "height"=>253, "url"=> "https://res.www.agrosoland.com/sam/image/upload/v1349196740/sample1.png", "secure_url"=> "https://d3jpl91pxevbkh.cloudfront.net/sam/image/upload/v1349196740/sample1.png", "next_cursor"=>"f329da74de2a9ac9cbf99d2a6bc147b8", "derived"=> [{"transformation"=>"c_fill,h_50,r_20,w_70", "format"=>"png", "bytes"=>7313, "id"=>"a3b44a715c63f7ee91f11fb20b97c5df", "url"=> "https://.../sam/image/upload/c_fill,h_50,r_20,w_70/v1349196740/sample1.png", "secure_url"=> "https://.../sam/image/upload/c_fill,h_50,r_20,w_70/v1349196740/sample1.png"}, {"transformation"=>"c_fill,h_75,w_75/jpg", "format"=>"jpg", "bytes"=>2889, "id"=>"7c0ca85b966b928179ce336fa2a7d1f8", "url"=> "https://.../sam/image/upload/c_fill,h_75,w_75/v1349196740/sample1.jpg", "secure_url"=> "https://.../sam/image/upload/c_fill,h_75,w_75/v1349196740/sample1.jpg"}]}
和现在相同例子
PHP:
api->resource (sample1));
ython语言:
cloudinary.api.resource("sample1")
并
节点js:
cloudinary.api.resource("sample1", function(result) { console.log(result) })
最后一个例子-获取单变细节,包括分配到此变形的所有图像列表
$ result = Cloudinary::Api.transformation("c_fill,h_75,w_75/jpg") => {"name"=>"c_fill,h_75,w_75/jpg", "allowed_for_strict"=>false, "used"=>true, "info"=>[{"width"=>75, "height"=>75, "format"=>"jpg", "crop"=>"fill"}], "derived"=> [{"public_id"=>"sample1", "resource_type"=>"image", "type"=>"upload", "format"=>"jpg", "url"=> "https://.../sam/image/upload/c_fill,h_75,w_75/v1349196740/sample1.jpg", "secure_url"=> "https://.../sam/image/upload/c_fill,h_75,w_75/sample1/sample1.jpg", "bytes"=>2889, "id"=>"7c0ca85b966b928179ce336fa2a7d1f8"}, ...}
如你所见,新API相当强使用此API允许完全控制所有上传原始文档和图像,获取社会简介图片,生成变换等
更多例子和全参考文件见
详细文档.
对每次API调用时,标准HTTP页眉都返回,并详细记录当前使用量统计,包括时限数、剩余动作数和时数重置时间
信头可能长得像
X-FatureLimit-Limit:500
X-FeatureRateLimit-Remaining: 499
X-FatureLit重置:wed,03Oct 20128:00GMT
注意客户库很容易访问回退限页眉Ruby举例说:
$=云型:Api.resource_types++#2
新建管理员API面向所有免费付费计划万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万万
试一试并告诉我们你的想法
