8.4.9 上传IPFS对象接口
通过此接口可以将自定义的IPFS对象格式文件上传至IPFS网络,并输入存储为DAG对象和输出显示生成的密钥。
1. 接口地址:https://节点网关地址/ipfs/[peer名称]/上传key/api/v0/object/put
2. 通讯方式:POST
3. 请求参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备 注 |
---|---|---|---|---|---|
1 | 待添加文件 | arg | file | Y | 待添加到 ipfs 的文件路径 注:该参数应用于body中, 其他参数应用于URL。 |
2 | 是否递归添加目录内容 | inputenc | string | N | 输入数据的编码类型,protobuf或json类型中的一个,默认值为json |
3 | 是否最小输出 | datafieldenc | string | N | 数据字段的编码类型,text和base64,默认值为text |
4 | 是否固定 | pin | bool | N | 添加时是否固定IPFS对象,默认为false |
5 | 是否最小输出 | quiet | bool | N | 是否最小输出 |
示例
// POST
Curl "https:// 网关地址/ipfs/上传key /api/v0/object/put?inputenc=json&datafieldenc=text&pin=false "
-X POST \
-H "Content-Type: multipart/form-data" \
-F file=@"/sample-result.json"
4. 响应参数
序号 | 字段名 | 字段 | 类型 | 备注 |
---|---|---|---|---|
1 | CID | Hash | string |
示例
{
Hash": "QmXg9Pp2ytZ14xgmQjYEiHjVjMFXzCVVEcRTWJBmLgR39V"
}