币游国际平台

上传

最新更新:Jan-22-2024

Cloudinary上传能力使用后,可大容量上传媒体资产并使用各种选项定制上传方式

上传到云化物时,资产不单存储,云化物还自动分析并保存每种资产的重要数据,如格式、大小、分辨率、显色颜色等数据自动索引化以允许搜索这些属性

云端安全综合API便于从服务器端码直接从浏览器或移动应用上传媒体文件需要时,您也可以使用API执行非签名上传,但带有限一组可用上传参数作为安全防范

新云化

本指南深入概述云性上传API能力5分钟或更短时间启动基础上传(或更多上传)后端SDK快速启动.

快速启动时都提供代码配置SDK,运行首次上传并再执行数项其他常见云运算,所有操作都使用你最喜爱编程语言或框架

if you haven't over你现有资产到云内,你可能还想查看一下迁移指南.

快速示例

实例1上传本地hat.jpg图像使用文件名设置公共身份证.

实例2:

程序上传节点sSDK视频教程

视视频如何使用云端节点快速上传图像、视频和其他媒体文件SDK


基础上传

程序化上传资产或使用认证签名或非认证上载非签名但因安全原因受某些限制

上头上传API方法通过向下列云端URL发送HTTPSPOST请求,使文件直接调用云端:

https://api.www.agrosoland.com/v1_1/ / /加载

出处 :

  • 云名名云化产品环境
  • 资源类型文件类型上传有效值 :图像显示,原生,视频播放汽车自动检测文件类型

上传图像文件到云化demo产品环境时 发HTTPSPOST请求

https://api.www.agrosoland.com/v1_1/demo/image/upload

POST请求寄送云端取决于你是否正在制作验证请求或a未验证请求.

同步上传完成后 上传资产立即可用变送

小技巧
  • 使用自动加载特征懒惰移动你所有资产 从远程位置云
  • 企业客户可搭建账号使用EU或AP数据中心端点开始api-eu.www.agrosoland.comapi-ap.www.agrosoland.com互斥

验证请求

验证上传请求使用安全协议对 HTTPS执行并包括认证签名云名,api_keyi_secret参数.后端应生成签名,因为你永远不应该曝光i_secret客户端代码

验证请求所需参数:

  • 文件库文件上传可以是实数据(字数组缓冲区)、DataURI(Base64编码d)、远程FTP、HTTP或HTTPS现有文件URL或白板桶私储桶URL看吧文件源选项获取更多细节
  • api_key独有API密钥
  • 时间戳ix时间分秒计数(例如1315060076)。
  • 签名签名所有请求参数,包括timestamp参数,但不包括api_key参数、resource_type参数、cloud_name参数和file参数签名有效一小时

云化后端SDKs包包上传a并大大简化使用API方法,包括自动生成认证签名sdks上传时唯一需要的参数是文件库参数:api_key,时间戳签名SDK自动添加参数

并有大量可选性上传参数可添加到上传方法中,包括命名、人工指定或自动生成标签和元数据应用、输入变换或基于AI对上传资产的其他分析等等看可选上传参数参考全表

注解
如果不能或不想使用SDKs 人工生成签名.看 客户端上传文档示例 代码探索者上传多文件自客户端生成签名时使用后端组件

云形上传方法使用下列语法执行验证上传API调用HTTPS:

例举上传样本jpg文件云演示文集产品环境

块状资产上传

为支持大文件上传,云型SDKs包含一种方法,为网络问题提供一定程度的容度上头上传大方法上传大文件块云并需要大于100MB文件常与视频文件相关,因为视频文件往往大得多。

默认使用时上传大方法文件上传原始文件if资源类型未指定参数更多细节资源类型选项见资产类型.

注解
大于20GB的文件也需要异步上传 async参数集 真实性.需要上传大文件时可以 联系支持提高上传限值达100GB可见当前用法限制 控制台账号设置.

例举上传大视频文件命名my_large_video.mp4:

默认时块大小设为20MB,但使用MB可设为5MB块大小参数化例举上传大视频文件命名my_large_video.mp4块大小设置为 6MB

注解
块状上传有多项响应:块后一列只包含基本信息加 完成日期:假参数和全上传响应返回 完成:真内含响应

未认证请求

非认证上传请求是执行上传的选项,无需生成后端认证签名但由于安全原因,并非所有上传参数都可直接指向执行非签名上传调用

无签名上传选项受a控上传预置,因此,为使用此特征,你首先需要启动非签名上传上传页面控制台设置上传预置定义上传选项应用到未签名资产可以在任何时间点编辑预置值(或创建附加上传预设值),定义参数用于用户浏览器或移动应用非签名上传所有资产更多上传预设信息见上传预置向导

非认证请求所需参数:

  • 文件库文件上传可以是实数据(字数组缓冲区)、DataURI(Base64编码d)、远程FTP、HTTP或HTTPS现有文件URL或白板桶私储桶URL看吧文件源选项获取更多细节
  • 上传_预置- 无签名名上传预置定义对象未签名上传.

并有大量可选性上传参数可添加到上传方法中,包括命名、人工指定或自动生成标签和元数据应用、输入变换或基于AI对上传资产的其他分析等等安全理由受限集参数可用无签名上传请求上传参数大都可定义为 未签名上传预置

云后端SDKs还支持非签名上传方法作为执行选项未认证请求无需生成后端验证签名

执行非签名上传调用无签名加载云型SDKs方法设置上传_预置云名参数.例举上传样本jpg文件带未签名_1上传预置

小技巧
不使用或不想使用SDKs Cloudinary直接使用RESTAPI.看 客户端上传文档示例 代码探索者上传文件从客户端直接调用RESTAPI

上传响应

成功上传API调回响应包括访问上传文件的HTTP和HTTPS URLs其中包括分配公共标识和当前版本资产(媒体探索者应用管理API并用于构建变送URLs)、资产维度、文件格式和签名验证响应视通过可选参数而定,响应中还可能包括有价值的分析数据,如检测面部、显色颜色、exif等嵌入元数据、质量/可访问性和其他复杂媒体分析数据

重要点
云化未来可能为API响应通知增加更多字段,所以请确保响应解析保持逆向兼容性,不会因未知字段的存在而破解

以下是JSON响应返回实例

注解
URL返回响应 版本号,包括交付URL中的版本是可选的

错误处理

POST请求由云端接收处理后,上传API使用下列HTTP状态代码之一返回状态

  • - 两百块成功
  • 400-错误请求无效请求参数
  • 401-需要授权
  • 403-不允许
  • 404-找不到
  • 420-率有限
  • 500-内部错误联系支持

误用a或a报错时,云端响应用非k(非200)HTTP状态代码返回并用JSON格式返回


上传考量

币游平台网页版官方有多种方式上传资源到云型账号云化支持编译验证请求需要后端生成签名未认证请求带受限支持参数集

下表汇总上传资产的主要选项和对每一项资产加以考虑的一些考量

选项 描述性 考量
云后端SDKs 云后端SDK打包API,包括处理上传本身、签名认证和响应验证 大大简化上传码比直接调用RESTAPI
自动生成验证签名并验证响应
使你能够用所选语言编码
提供嵌入式支持加块上传大文件
上传部件 可嵌入网站或应用中交互性功能丰富界面,允许用户直接上传资产到云形 免开发内部交互文件上传解决方案
简单集成
QQ可用于非认证客户端上传
启动直接上传各种社交媒体和股市图片账号
上载优先API端 上头上传云端API支持验证请求需要后端生成签名未认证请求带受限支持参数集 QQ应用非认证客户端请求
Ludenarysdks使用非语言编码
需要人工编码上传验证响应
需要后端函数生成验证调用签名
从浏览器直接上传 云端后端SDKs也可以自动添加文件输入字段到表格中直接上传文件到云端,绕过自己的服务器 直接上传到您的账号中,绕过自己的服务器
需要附加搭建配置
需要云化jQuery插件
云化CLI 云型CLI(常线界面)使你能够通过命令行与云型交互并提供更多特征和助手命令 简单使用
帮助快速上传资产而不建立正式编码环境
用于实验上传参数和行为
QQ专用助手函数(例如同步)不直接通过其他上传选项提供
懒汉迁移 云性懒散迁移自加特性使你可按需迁移远程文件,即每次资产均自动上传至云性网络,首次请求交付该资产URL 简单实现
QQ上传真正需要的资产
万一定时远程内容无法使用则不合适
媒体探索者 云控制台媒体探索者页面允许你使用拖放或内置上传部件向账户上传资产 简单使用
帮助快速上传资产而不处理代码
用于实验上传预置行为
较不合适方式上传资产比程序化解决方案
整合 币游国际真人娱乐云化开发内部集成多大电子商务平台、CMS平台和PIM平台 币游国际真人娱乐帮助平台用户直接从平台UI上传云
币游国际真人娱乐需要平台管理员初始搭建配置
较不合适方式上传资产比程序化解决方案
媒体库部件 媒体库部件帮助嵌入所有云媒体库UI能力,包括上传能力 帮助实现自己的云化集成
与程序化解决方案相比,不太适宜作为大规模上传资产的主要方式

提示 :
  • 媒体播客云端工作流构建程序(目前为贝塔版)提供自自动化图像上传并低码实现选项媒体Flow文档上传.
  • 上传、变换和交付文件用法限制取决于您的云平面图.细节检查账号标签云控制台设置设置.

并见
  • 上传ai引用:提供REST和SDK语法、参数细节和所有上传API方法示例
  • 上传添加:通过上传调用中添加参数可激活多云附加子并发使你能够利用云化公司以及其他视觉和图像处理伙伴提供的特殊深学习、AI和其他分析能力
  • 资产管理:覆盖程序化管理资产选项,包括各种CRUD选项、备份和版本管理、通知和Webhooks以及认证和签名选项

反馈发送

评分本页 :