Save:将导出的图纸保存到您的存储
POST /save/{format} 以与 Export 相同的方式、按其支持的任意格式导出图纸,并将文件保存到您已注册的某个存储中,而不是直接返回。响应会说明文件保存到了何处。
请求正文与 Export 相同(模板或其 source、values、options),另加:
destination:保存位置,包括存储和键:{ "storage": "main", "key": "drawings/box-500.pdf" }。以/结尾的键表示文件夹:文件会以drawing.加上该格式的扩展名保存在其中。overwrite:替换已存在的文件。除非此项为true,否则已存在的文件会被拒绝(409)。
示例
POST /save/pdf
X-API-KEY: your-api-key
Content-Type: application/json
{
"source": { "storage": "main", "key": "templates/box.piq" },
"values": { "L": 500, "W": 250 },
"destination": { "storage": "main", "key": "drawings/box-500.pdf" }
}
201 Created:
{
"storage": "main",
"key": "drawings/box-500.pdf",
"contentType": "application/pdf",
"size": 1311,
"eTag": "\"fb867be5ca2d368a0127f37964ba0c70\"",
"warnings": 0
}
在生成图纸之前会先检查目标位置:未知的存储返回 404,无法使用的键(以 / 开头或含有 ..)返回 400。存储无法访问或拒绝其密钥时,返回 502。
将图纸保存为 piq 会在您的存储中生成一个模板,并以给定的值作为其自身的值:这是保存变体的一种方法。