1. 需要先做的事

1. 生成一对 RSA 的密钥（最好是 RSA2048 ）
2. 在 @vsharecloud_bot 内，点击我的信息，记录用户 ID ，然后点击 API Keys ，上传刚刚生成的 RSA 密钥对的公钥。

2. 一般请求

本 API 均为 POST 请求。每一个请求都只有两个参数。

{
    "data":"",
    "sign":""
}

data 内是一段经过 base64 处理的 JSON ， sign则是经过 base64 处理之后的 使用刚刚生成的 RSA 私钥以及采取 SHA-256 方式对刚刚的 JSON 进行签名之后的数据。

接下来所说的的每一个请求的 JSON 都是指 这个需要经过 base64 处理的 JSON 数据。

这个 JSON 的初始数据：

{
    "uid":<刚刚记录的用户id>
}

默认返回格式

{
    "status": true,
    "data": {},
    "msg": ""
}

字段说明：

字段	说明
status	true 则表示请求成功，false 则为失败。
data	如果请求成功且有返回数据， data 代表所返回的数据，JSON （字典）格式。
msg	如果请求失败，则会有失败的原因。

下文中返回的数据皆为data字段内的数据。

3. 查询账户信息

URL：

https://api.vshare.cloud/api/v1/userinfo

JSON 无其他请求参数

返回数据

{
    'id': <用户id>,
    'money': <当前余额，float格式>
}

4. 查询账户所存的所有文件的CID

URL:

https://api.vshare.cloud/api/v1/filelist

JSON无其他请求参数

返回数据

{
    "cids":<储存的所有cid，列表格式>
}

5. 查询账户所存的单个CID的详细信息

URL:

https://api.vshare.cloud/api/v1/getfile

额外请求参数：

字段	说明
cid	请求文件的CID

返回数据：

字段	说明
cid	文件的CID
status	“SAVED” 为保存，”PROCESSING” 为正在储存， “PENDING” 为等待储存。
size	文件大小，纯数字格式，单位为B
size_str	文件大小，视觉友好的格式
price	当前的价格，单位为 USDT/MO
filename	文件名，如果没设置则为null

URL:

https://api.vshare.cloud/api/v1/addfile

额外请求参数：

字段	说明
cid	请求文件的CID

无特殊返回参数

URL:

https://api.vshare.cloud/api/v1/delfile

额外请求参数：

字段	说明
cid	请求文件的CID

无特殊返回参数