对象存储

    • 对象存储 > 使用指南 > 开发指南 > 上传资源 > 简单反馈

    简单反馈

    最近更新时间: 2021-05-13 18:43:09

    简单反馈是最直接的 HTTP 响应方式。客户端发起一次上传请求，然后等待服务端返回结果。服务端在处理完这次上传请求后，将处理结果以 HTTP 响应的方式反馈给客户端。

    如果资源上传成功，服务端会响应 HTTP 200 返回码，且在响应内容中包含两个字段：

    • hash：已上传资源的校验码，供用户核对使用。
    • key：目标资源的最终名字，可由七牛云存储自动命名。

    以下是一个典型的上传成功响应：

    HTTP/1.1 200 OK

Content-Type: application/json
Cache-Control: no-store

{
   
    "hash": "Fh8xVqod2MQ1mocfI4S4KpRL6D98",
    "key": "gogopher.jpg",
}

    如果资源上传失败，服务端会反馈相应的错误信息。例如 HTTP 401 代表验证失败，此时响应内容中会包含详细的错误信息，为 JSON 格式：{“error”:"<reason>"}。

    以下是一个典型的上传失败响应：

    HTTP/1.1 400 Bad Request
Date: Mon, 05 Aug 2013 13:56:34 GMT
Server: nginx/1.0.14
Content-Type: application/json
Access-Control-Allow-Origin: *
Content-Length: 28
X-Log: MC;SBD:10;RBD:11;BDT:12;FOPD/400;FOPG:63/400;IO:109/400
X-Reqid: -RIAAIAI8UjcgRcT
X-Via: 1.1 jssq179:8080 (Cdn Cache Server V2.0), 1.1 jsyc96:9080 (Cdn Cache Server V2.0)
Connection: close
{
    
    "error":"invalid argument"
}

    这些返回的错误信息可以帮助开发者分析问题原因。完整的返回码信息请参考错误码列表。

    从上面的错误示例中可以看到，响应头中还包含了一些以X-为前缀的扩展字段，如：X-Reqid 和 X-Log 等。这些扩展信息非常有助于定位问题。我们建议开发者将所有接收到的错误信息写到日志中，以便于我们的技术支持人员在协助分析问题时有足够详细的线索。

    以上内容是否对您有帮助？
    • Qvm free helper
    Close