私有网络是搭建了两个节点，node1和node2，分别对应端口为5001和5002。
使用postman工具进行接口调用。
- api/v0/add: 上传文件
pin默认也为true。
# req
http://ip:5001/api/v0/add?pin=true
body: form-data key：选择文件，参数名可选。 value：选择本地文件。
# res
{
"Name": "微信截图_20230825110844.png",
"Hash": "QmWmKRtGEYeMk8rvudyi1245PtHXY4CDrh9jwvYL6QP1SF",
"Size": "47739"
}
- /api/v0/cat: 下载文件
# req 点击按钮“send and download”
http://ip:5002/api/v0/cat?arg=QmWmKRtGEYeMk8rvudyi1245PtHXY4CDrh9jwvYL6QP1SF
# res
选择本地Windows的存储路径以及文件类型，保存本地后进行查看即可。
- /api/v0/cat【待完善 】: 下载文件
注意：通过该接口进行文件的下载时发现内容流的开始部分增加了内容，导致部分文件无法正常打开。
- api/v0/pin/add：将某个对象进行本地存储。
目标： 将node1上的某个对象pin至node2本地。
- 查看pin列表
通过接口分别查看下node1和node2上的pin列表信息。
node1的pin列表:
# req post
http://ip:5001/api/v0/pin/ls
# res
{
"Keys": {
"QmR9PYvA7mo1edPU7KGwwdu1dj2pVnHczr4nTyjCPHgA5M": {
"Type": "recursive"
},
"QmUNLLsPACCz1vLxQVkXqqLX5R1X345qqfHbsf67hvA3Nn": {
"Type": "recursive"
},
"QmV68p53niYgegZomGbHCjm74dpwdoQjDf45L3QVkFfFsN": {
"Type": "recursive"
},
"QmWmKRtGEYeMk8rvudyi1245PtHXY4CDrh9jwvYL6QP1SF": {
"Type": "recursive"
},
"Qmc1uQs7hRaXmLqkD4yA1pCydFFCU2mmiSQEaSv6woWCwM": {
"Type": "recursive"
}
}
}
node2的pin列表:
# req post
http://ip:5002/api/v0/pin/ls
# res
{
"Keys": {
"QmNRE8y7uZZXdMMPJ3ocXaTQWPdAyVWULnLURC8f3imvsg": {
"Type": "recursive"
},
"QmUNLLsPACCz1vLxQVkXqqLX5R1X345qqfHbsf67hvA3Nn": {
"Type": "recursive"
}
}
}
- 进行pin操作
下面将node1上QmWmKRtGEYeMk8rvudyi1245PtHXY4CDrh9jwvYL6QP1SFpin至node2：
# req
http://ip:5002/api/v0/pin/add?arg=QmWmKRtGEYeMk8rvudyi1245PtHXY4CDrh9jwvYL6QP1SF
# res
{
"Pins": [
"QmWmKRtGEYeMk8rvudyi1245PtHXY4CDrh9jwvYL6QP1SF"
]
}
- 验证pin结果
通过api再次查看node2的pin列表：
# req post
http://ip:5002/api/v0/pin/ls
# res
{
"Keys": {
"QmNRE8y7uZZXdMMPJ3ocXaTQWPdAyVWULnLURC8f3imvsg": {
"Type": "recursive"
},
"QmUNLLsPACCz1vLxQVkXqqLX5R1X345qqfHbsf67hvA3Nn": {
"Type": "recursive"
},
"QmWmKRtGEYeMk8rvudyi1245PtHXY4CDrh9jwvYL6QP1SF": {
"Type": "recursive"
}
}
}
上述，可以看到接口的响应内容中，包含了QmWmKRtGEYeMk8rvudyi1245PtHXY4CDrh9jwvYL6QP1SF。
