预请求 (OPTIONS Object)
Qiniu S3 API 服务支持跨域资源共享 (CORS) 请求,该接口定义了客户端 (主要指浏览器和 Adobe Flash Player) 端向某个对象 (Object) 发送实际请求前的预请求 (preflight request) 服务.客户端可以通过该接口检查是否可以使用指定的域 (Origin)、请求方法 (HTTP Method) 和请求头 (HTTP Header) 发送具体请求。
注意: Qiniu S3 API 暂不支持通过客户端通过接口设置 CORS 配置,你必须联系我们做配置!
请求定义
OPTIONS /<BucketName>/<ObjectName> HTTP/1.1
Host: api-s3.qiniu.com
Date: <date>
Origin: <origin>
Access-Control-Request-Method: <HTTP Method>
Access-Control-Request-Headers: <HTTP Header> [, <HTTP Header>]
请求参数
该接口未定义请求参数
请求头
除 请求头 (HTTP Request Header) 外,该接口定义了以下请求头:
名称 | 描述 | 要求 |
---|---|---|
Origin | 指定请求的源域名,如 https://www.example.com | Y |
Access-Control-Request-Method | 指定跨域请求的 HTTP Method,如 PUT | Y |
Access-control-Request-Headers | 指定跨域请求的自定义 HTTP Headers 列表,如 X-PINGOTHER | CY |
- CY, 条件约束必须
- Y, 必须
请求数据
该接口未定义请求数据
响应定义
该接口未定义响应数据
- 服务器端正确处理请求时响应 HTTP 状态码为 200
该接口定义了以下 HTTP 响应头数据
名称 | 描述 |
---|---|
Access-Control-Allow-Origin | 允许跨域请求的域名 |
Access-Control-Allow-Methods | 允许跨域请求的 HTTP Methods 列表 |
Access-Control-Allow-Headers | 允许跨域请求的自定义 HTTP Headers 列表 |
Access-Control-Expose-Headers | 允许跨域请求的客户端脚本访问 HTTP Response Headers 列表 |