接口规则与权限说明

资源限额

• 1、用户默认可用空间为 2GB，只计算文件体积占用的空间，目录不计入空间使用量。
• 2、用户通过接口上传的文件最大支持 500 MB。
• 3、请求频次限制。
  • 针对一个应用IP的请求次数限制：
    • 应用未审核：100 次/分钟
    • 普通授权：200 次/分钟
    • 中级授权：350 次/分钟
    • 高级授权：500 次/分钟
    • 合作授权：700 次/分钟
  
  
  • 针对一个用户在使用一个应用的请求次数限制：
    • 应用未审核：20 次/分钟
    • 普通授权：30 次/分钟
    • 中级授权：50 次/分钟
    • 高级授权：100 次/分钟
    • 合作授权：无限制
• 4、上下行流量限制。
• 5、目前，一个目录下最多可以允许 1000 个子目录，最多允许 10000 个文件。
• 6、执行复制、移动和删除目录操作时，涉及到的目录下全部子目录和文件数不超过 5000 个时操作可以执行；若超出此限额，操作不会执行，系统给出提示消息。

字符集和编码

• 1、所有字符串都应以 UTF-8 字符集编码。
• 2、作为请求 URI 或参数的路径，或者搜索接口所使用的查询关键字中的英文字母大小写采用“保留但不区分”策略，即写操作时使用的大写或小写会记录下来，但读操作时不区分大小写。
• 3、其它字符串参数区分大小写，类型是整数的参数只允许半角数字。所有请求的路径及参数，请参照 RFC 3986 进行 URI 编码。

文件、目录路径规则

• 1、从最开头的 / 符算起，包含目录和文件名的路径总体长度不能超过 200 字符，其中包括 / 符在内的各级目录的路径总长度最多占用 188 字符。
• 2、路径中以 / 符分隔的每一级不能全是空白字符（半角空格、回车符和换行符）或句点的组合。
• 3、不能包含 \ / : ? * " > < | NUL 以及不可打印字符（ASCII 码为 0 到 31 和 127 的字符）；
• 4、不能使用以下 Windows 系统保留字：CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9。
• 5. 不能包含Emoji表情，具体字符请参见 http://en.wikipedia.org/wiki/Emoji

用户空间隔离

• 1. 用户在使用微盘平台上的产品时，都有自己总的空间配额，初始用户完成新手任务后为10GB。用户可通过签到等日常使用活动增加可用的空间配额。
• 2. 一个用户可以同时使用多个基于微盘平台的应用。它们的可用空间上限都是用户当前剩余的可用空间。
• 3. 各个应用之间的空间是互相隔离的。每个应用默认有属于自己的 sandbox 级的空间。经过特殊授权的应用可以使用basic 级的公共空间。
• 4. 某应用自己的 sandbox 空间只能被本应用访问，其它应用都不能访问，可以保证本应用的数据不受其它应用影响。
• 5. 如果使用 basic 空间，则所有使用basic 空间的应用，都可以操作 basic 空间内的数据，即其它应用也可操作该应用的数据。