# OSS接口规范和错误响应


<!--more-->


## 1. 开放接口规范

开发者在发送请求给 OSS 时，既可以使用 带签名认证的请求，也可以使用匿名访问。

OSS提供的相关API官方文档: https://help.aliyun.com/document_detail/31957.html#reference-ahf-k4t-tdb

例: 

- 关于service的操作

  GetService (ListBuckets) 返回请求拥有者的所有bucket

- 关于bucket的操作

  createBucket, putBucketACL, getBucketInfo..............

- 关于object的操作

  putObject, copyObject, getObject, .................

- 关于 multipart upload的操作

  InitiateMultipartUpload(初始化多文件上传事件) , uploadPart(分块上传)................

- 跨域资源共享 cors

  putBucketcors(在指定bucket设置一个cors规则), ...............

- live channel操作

## 2. 错误响应

- 响应格式

  当用户访问OSS出错时，OSS会返回给用户一个合适的3xx，4xx或者5xx的HTTP状态码；以及一个application/xml格式的消息体

  所有错误的消息体中都包括以下几个元素：

  - Code：OSS返回给用户的错误码。
  - Message：OSS给出的详细错误信息。
  - RequestId：用于唯一标识该次请求的UUID；当你无法解决问题时，可以凭这个RequestId来请求OSS开发工程师的帮助。
  - HostId：用于标识访问的OSS集群（目前统一为oss.aliyuncs.com）

- 错误码

  [官方文档](https://help.aliyun.com/document_detail/185794.html)