ipfs - /api/v0/add

将指定的文件或目录添加到IPFS中。

API请求

POST https://ipfs.infura.io:5001/api/v0/add?recursive=false&quiet=<value>&quieter=<value>&silent=<value>&progress=<value>&trickle=<value>&only-hash=<value>&wrap-with-directory=<value>&hidden=<value>&chunker=<value>&pin=true&raw-leaves=<value>&nocopy=<value>&fscache=<value>&cid-version=0&hash=sha2-256

请求参数：

• file：要添加的文件路径，必需
• recursive：是否递归添加，可选，默认值：false
• quiet：是否使用安静模式，可选
• quieter：是否使用更安静模式，可选
• silent：是否使用沉默模式，可选
• progress：是否显示进度数据，可选
• trickle：是否使用trickle-dag格式生成DAG，可选
• only-hash，是否仅显示数据块和哈希，不写入磁盘，可选
• wrap-with-directory：是否用目录对象包裹要写入的文件，可选
• hidden：是否包含隐藏文件，可选，默认值：false
• pin：是否固定添加的对象，可选，默认值：false
• raw-leaves：使用为叶节点使用裸块，可选，该参数为实验性质
• nocopy：是否使用filestore添加文件，可选，该参数为实验性质
• fscache：是否检查filestore中之前存在的块，可选，该参数为实验性质
• cid-version：cid版本，int，可选，默认值：0，实验性质参数
• hash：要使用的哈希函数，字符串，可选，默认值：sha2-256

请求示例：

curl "https://ipfs.infura.io:5001/api/v0/add?pin=false" \
    -X POST \
    -H "Content-Type: multipart/form-data" \
    -F file=@"/sample-result.json"

API响应

响应结果对象结构如下：

• Name：对象名称
• Hash：上传对象的哈希
• Size：字节数

响应结果示例：

{
    "Name": "sample-result.json",
    "Hash": "QmSTkR1kkqMuGEeBS49dxVJjgHRMH6cUYa7D3tcHDQ3ea3",
    "Size": "2120"
}