API 接口与 SDK

1. 是否有检查文件是否存在的接口?

没有此类接口提供。可以通过 API HEAD 请求文件,返回 200 表示存储中文件存在,返回 404 则表示不存在。

2. 使用 API 上传,提示:401 signature error?

签名错误。可能情况:

  • 操作员密码错误,可以到控制台右上角 账户管理 中重置;
  • 签名格式错误;
  • 服务器时间格式错误;
  • 计算签名时拼接的参数不正确,请严格按照鉴权文档进行拼接;
  • 计算签名时使用的加密函数不正确。

您可以参考 又拍云存储鉴权实现之大白话教程 或参考 DEMO 大全 使用。

3. 使用 API 上传,提示:401 need date header?

发起的请求缺少 Date 头信息。
可能情况:发起的接口请求 HEADER 中缺少 Date 参数。
注意:部分 HTTP Client 开发包在发起 GET 请求时不自动加入 Date 参数。

4. 使用 API 上传,提示:401 date offset error?

发起请求的服务器时间错误。
可能情况:服务器时间错误,请检查服务器的时间是否与世界时间有较大偏差。

5. 使用 API 上传,提示:401 user blocked?

操作员被禁用。

6. 使用 API 上传,提示:403 not an image?

请求资源不是图片类型。
可能情况:上传非图片文件,但是使用了图片处理参数。

7. 使用 API 上传,提示 :401 user need permission?

操作员需要授权。
可能情况:操作员未授权相应操作的权限。

8. 删除文件的时候返回 40300011 has no permission to delete?

没有权限删除。
可能情况:操作员没有授权删除权限。

9. 使用 API 上传,提示:403 bucket blocked?

空间被禁用或者没有进行实名认证。

10. 使用 API 上传,提示:403 authorization has expired?

不接受请求,授权已过期。 可能情况:

  • 在 policy 信息中设置 expiration 授权过期时间过短;
  • 服务器时间与世界标准时间偏差过大。

11. 使用 API 上传,提示:403 form api disabled?

不接受请求,未开启文件秘钥,可以到对应的云存储服务中的配置里开启。

12. 使用 API 上传,提示:403 file too small?

不接受请求,上传的文件容量过小。
可能情况:在 policy 信息中设置的 content-length-range 参数是否过大。

13. 使用 API 上传,提示:403 file type error?

不接受请求,上传的文件类型不被允许。
可能情况:在 policy 信息中设置的 allow-file-type 不包含当前上传的文件类型。

14. 使用 API 上传,提示:403 content md5 not match?

不接受请求,上传的文件 md5 校验错误。
可能情况:在 policy 信息中设置的 content-md5 校验值与表单接收到的文件 md5 不一致。

15. 使用 API,提示:404 Not Found?

请求的文件不存在。
可能情况:

  • 在上传文件过程中遇到 404 错误,请检查上传文件路径的目录路径是否存在;
  • 在下载文件过程中遇到 404 错误,请检查文件名和路径是否存在。

16. 使用 API,提示:406 dir not acceptable?

不接受请求。
可能情况:

  • 在上传文件过程中遇到 406 错误,请检查上传文件名是否已经被用于存在的目录;
  • 在上传文件过程中遇到 406 错误,如有设置 Content-MD5 校验,可能是又拍云服务器端收到的文件内容 MD5 不一致。请检查 API 接口请求时设置的 Content-MD5 值;
  • 在创建目录过程中遇到 406 错误,请检查目录名是否已经被用于存在的文件。

这篇文章有帮助吗?

相关文章