对象存储

  • 简单反馈

    最近更新时间:2017-08-02 17:07:08

    简单反馈是最直接的 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":"\"}。

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

    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 等。这些扩展信息非常有助于定位问题。我们建议开发者将所有接收到的错误信息写到日志中,以便于我们的技术支持人员在协助分析问题时有足够详细的线索。

    关于这些扩展字段的详细描述,请参考公共响应头

    以上内容是否对您有帮助?
  • 提交工单