分发地址格式

binedge 上每个文件的地址都由三部分组成：你的空间名、说明地址用途的域名角色，以及对象 key。

https://<space>.<role>.binedge.net/<object key>?<parameters>

域名角色

角色	域名	存储桶	方法	签名
edge	<space>.edge.binedge.net	公开，只读	GET、HEAD	只在带改图参数时需要
vault	<space>.vault.binedge.net	私有，只读	GET、HEAD	必须，带 exp
upload	<space>.upload.binedge.net	私有，只写	PUT、POST、PATCH、HEAD、OPTIONS	必须，带 exp、max_bytes 和 types

行为事件发到 <space>.collect.binedge.net，用法随行为分析 SDK 说明。

对象 key

路径就是完整的对象 key，含环境前缀：

前缀	用途
production/	生产服务器写入的文件
shared/	各环境共用的文件，用生产密钥签名
dev/	开发和测试服务器写入的文件

key 最长 1023 字节 UTF-8，不能含控制字符，也不能有 . 或 .. 段。

路径编码

每一段路径按 RFC 3986 做百分号编码，段与段之间保留 /。签名按解码后的 key 计算，所以同一个文件无论路径怎么写，签名都一样。

对象 key	地址里的路径
production/tickets/截图 1.png	/production/tickets/%E6%88%AA%E5%9B%BE%201.png
dev/support-tickets/7/a+b%c~d.pdf	/dev/support-tickets/7/a%2Bb%25c~d.pdf
shared/logos/g 1.png	/shared/logos/g%201.png

路径里的 + 就是加号，不是空格。

缓存

• edge 上的公开文件缓存在边缘节点。文件内容变了就换一个 key 上传，不要覆盖旧文件，访客就不会拿到旧副本。
• edge 上改过尺寸的图片按含参数的完整地址缓存一年。
• vault 的响应从不缓存：Cache-Control: private, no-store。
• vault 支持 Range 请求，音视频播放器可以拖动进度。

错误

在 edge 和 vault 上，返回 403、404 或服务端错误的请求会被重定向到 https://www.binedge.net/404，访客看到的是一个页面而不是错误正文。upload 直接返回错误本身，格式是 JSON：

{"error":{"class":"not_found","message":"...","retryable":false,"platform_code":null,"platform_message":null,"operation_id":null}}

HTTP	class	常见原因
403	permission_denied	签名缺失、不对或已过期，见签名链接
404	not_found	这个 key 下没有文件，或分片上传已过期
422	validation_failed	key 或参数不合法，文件类型或大小超出限制，或 Range 超出文件范围