感谢大家阅读本篇指南。
钛盘支持通过 CLI 上传文件,这主要是方便用于某些特定环境:在 Linux 服务器上,通过命令行便利地上传文件到钛盘。因此,从设计上来说,它并不是一个我们通常认为的 API,不适用于自动化场景,比如集成到博客,或者应用中。
整个 CLI 文件上传使用流程分为以下 2 点:
1,登录钛盘,然后在上传文件的界面,选择好有效期后,进入选择上传文件的环节,此时就可以看到选项,使用 CLI 来上传文件。在这个地方,系统会为文件上传的 CLI 命令分配足够的参数,比如如果当前是在文件夹中进行上传,那么生成的 CLI 命令会包含了文件夹的参数。
2, 在服务器上执行 CLI 上传命令,只需要修改命令中关于文件位置部分的参数,那么对应的文件就会上传到对应的中继服务器,并最终移送到存储节点。
执行结果:
1,Upload Complete.
完成了上传,并会给出下载地址。
2,Invalid requests.
上传失败,因为上传请求中的参数不正确。
3,This account(or IP) has reached the maximum file upload limit for a single day. Please retry tomorrow.
上传失败,超出配额。目前上传到临时空间,每天每个账户可以拥有 100GB 的配额,超出这个部分时就会提示此错误。上传到私有空间不会有这个限制。
4,File Size Exceeds Limit.
超出了单个文件的大小限制,目前是 50GB。
5,If you do not have enough private storage space, please purchase a private space expansion pack.
上传到私有空间的文件,已经超过了账号所持有的私有空间容量。
6,Server busy.
系统超载,请稍后再试。
7,This Token has been unavalible.
Token 中没有包含有效的用户信息,无效。
关于终端标识(标识,Token)的有效期
这是大家疑问比较集中的地方,即标识的有效期到底是多长?这个问题很简单:1年之后无访问。
要理解这个问题,首先需要说一下标识的作用。
标识的设计目的,是为了标识用户终端而存在的,它会在浏览器初次访问时,通过钛盘的 API 申请并获得。每个浏览器都是都一不二的,因此上面说过,只有在登录钛盘之后,在文件上传时,才能生成上传命令。在钛盘上的一切操作都会绑定到这个标识。
但是,标识并不会一直绑定到具体某个用户。
比如说,当你在浏览器中退出钛盘的登录之后,标识并不会发生改变,但是标识所标记的用户已经发生了改变。这不会影响到下一位登录的用户。下一个用户登录时,也会应用此标识来在钛盘进行各种操作。
因此,如果你在使用命令行上传命令上传文件结束之后,得到了 “This Token has been unavalible” 的反馈,那么就只有一种情况,上传命令绑定的标识的用户,在浏览器上已经退出了登录。
命令行上传可以被视为 API 吗
因人而异,但总的来说,它不适合作为 API 使用。
首先,尽管它确实包含了用于文件上传的 URL,也给出所需的参数以完成功能。但是本质上来说,它是为命令行操作而设计的,在很多场景上没有作考虑,比如大家最长遇到的 This Token has been unavalible 问题,就是没有理解它的工作机制导致的。其次,钛盘仍然可能会根据功能对这个上传命令做出改进和调整,因此它是不稳定的。
当然,如果你已经彻底理解了用法,也不是不能作为一种 API 来使用,只要方法正确,那么就能获得正确的结果。
将来会有专门的 API 吗
将来会有。