8.4.6 写入IPFS块接口
通过此接口可以将自定义文件数据结构上传至IPFS网络。
1. 接口地址：https://节点网关地址/ipfs/[peer名称]/上传key/api/v0/block/put
2. 通讯方式：POST
3. 请求参数
| 序号 | 字段名 | 字段 | 类型 | 必填 | 备 注 |
|---|---|---|---|---|---|
| 1 | 待添加文件 | arg | file | Y | 需要被存储为IPFS块的数据注：该参数应用于body中, 其他参数应用于URL |
| 2 | 格式 | format | string | N | 所创建块的cid格式,默认为v0 |
| 3 | multihash类型 | mhtype | string | N | 默认为sha-256 |
| 4 | multihash长度 | mhlen | int | N | 默认为-1 |
| 5 | 是否固定 | pin | bool | N | 以递归方式固定添加的块，默认为false |
示例
// POST
curl "https:// 网关地址/ipfs/上传key /api/v0/block/put?format=v0&mhtype=sha2-256&mhlen=-1&pin=true "
-X POST \
-H "Content-Type: multipart/form-data" \
-F file=@"/sample-result.json"
4. 响应参数
| 序号 | 字段名 | 字段 | 类型 | 备注 |
|---|---|---|---|---|
| 1 | 键值 | Key | string | |
| 2 | 大小 | Size | int |
示例
{
"Key": "QmTStHSziV4cfuYaHKbRYnmBb5XCzdj67kV7jNvbKKr2qv",
"Size": 162
}