Save: el dibujo exportado a su almacenamiento
POST /save/{format} exporta el dibujo como lo hace Export, en cualquiera de sus formatos, y
guarda el archivo en uno de sus almacenamientos registrados en lugar de devolverlo. La respuesta indica dónde se ha
guardado.
El cuerpo es el de Export (la plantilla o su source, values, options), más:
destination: dónde guardarlo, un almacenamiento y una clave:{ "storage": "main", "key": "drawings/box-500.pdf" }. Una clave que termina en/es una carpeta: el archivo se guarda en ella comodrawing.más la extensión del formato.overwrite: reemplazar un archivo que ya existe. Si no estrue, un archivo que ya existe se rechaza (409).
Ejemplo
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
}
El destino se comprueba antes de generar el dibujo: un almacenamiento desconocido se responde con 404, y una clave que
no puede usarse (que empieza por / o contiene ..), con 400. Un almacenamiento al que no se puede acceder o que
rechaza sus claves se responde con 502.
Guardar el dibujo como piq crea con él una plantilla en su almacenamiento, con los valores dados como propios: una
forma de conservar variantes.
Consulte también: API, Export, Registrar un almacenamiento.