Biblioteca de archivos API

Para evitar la necesidad de volver a subir todos los archivos cuando se pide el mismo artículo, tus archivos de impresión se guardarán en la Biblioteca de archivos para que puedas reutilizarlos.

Puedes utilizar esta API para añadir archivos directamente a tu biblioteca, y más tarde utilizar el ID de archivo al crear un pedido. Sin embargo, la manera más cómoda de hacerlo es especificando los archivos por URL al mismo tiempo que se crea el pedido.

Probablemente nunca utilices esta API: solo especifica el archivo URL cuando crees un pedido y los archivos se añadirán automáticamente.

El procesamiento de archivos puede requerir mucho tiempo, así que se procesan de manera asíncrona. Tras añadir un archivo, este se guarda con el estado esperando y se descarga y procesa más tarde. Después, el estado se cambia a ok si el archivo se carga con éxito y el archivo tiene una imagen válida, o fallido si el proceso no ha sido exitoso. Algunos archivos de campos de metadatos, como las dimensiones y resolución, solo se rellenan cuando el archivo se ha procesado.

Si un pedido con un archivo se ha confirmado antes de que el archivo se haya procesado, y el archivo resulta ser inválido, entonces el pedido vuelve a estado fallido y necesita ser corregido y confirmado otra vez.

Si intentas añadir un nuevo archivo con una URL idéntica a la de un archivo existente, no se crea ningún archivo nuevo, y el sistema vuelve al antiguo sin actualizar sus contenidos.

Recuerda: si has cambiado el original, asegúrate de cambiar también la URL para futuros pedidos, de lo contrario se reutilizará la antigua versión.
Puedes añadir una marca de tiempo "última modificación" al final de la URL para asegurar que la URL es diferente para los archivos cambiados.

Los archivos que se añaden a través de la API pueden configurarse para no ser mostrados en la Biblioteca de archivos en la web, cambia el atributo visible a falso al crearlos.

Get list of files

GET https://api.printful.com/files

Returns list of last added files
Parámetros de entrada
status string Filter by file status
offset integer Result set offset
limit integer Number of items per page (max 100)
Formato de respuesta:
code integer Código del estado de respuesta 200
result File [ ]
id integer File ID
type string Role of the file in the order
hash string MD5 checksum of the file
url string Source URL where the file is downloaded from
filename string File name
mime_type string MIME type of the file
size integer Size in bytes
width integer Width in pixels
height integer Height in pixels
dpi integer Resolution DPI.
Note: for vector files this may be indicated as only 72dpi, but it doesn't affect print quality since the vector files are resolution independent.
status string File processing status:
ok - file was processed successfuly
waiting - file is being processed
failed - file failed to be processed
created timestamp File creation time
thumbnail_url string Small thumbnail URL
preview_url string Medium preview image URL
visible boolean Show file in the Printfile Library (default true)
paging Paging Información sobre la paginación
total integer Número total de artículos disponible
offset integer Fijar resultado actual de compensación de página
limit integer Número máximo de artículos por página
Clave API
status Filter by file status
offset Result set offset
limit Number of items per page (max 100)
Ejecutar
Lista de archivos con un archivo recién añadido y tres que ya se han procesado.
Datos de respuesta:
{
    "code": 200,
    "result": [{
        "id": 11815,
        "type": "default",
        "hash": null,
        "url": "http://www.example.com/images/tshirts/front_123.pdf",
        "filename": null,
        "mime_type": null,
        "size": 0,
        "width": null,
        "height": null,
        "dpi": null,
        "status": "waiting",
        "created": 1390818471,
        "thumbnail_url": null,
        "preview_url": null,
        "visible": true
    }, {
        "id": 10003,
        "type": "preview",
        "hash": "8a635765cc782c8c72a2a37ab7729a07",
        "url": "http://example.com/images/tshirts/preview_1.jpg",
        "filename": "tshirt_preview.jpg",
        "mime_type": "image/jpeg",
        "size": 19941,
        "width": 420,
        "height": 200,
        "dpi": 72,
        "status": "ok",
        "created": 1390818271,
        "thumbnail_url": "https://www.printful.com/storage/files/1559/8/8a635765cc782c8c72a2a37ab7729a07_thumb.png",
        "preview_url": "https://www.printful.com/storage/files/1559/8/8a635765cc782c8c72a2a37ab7729a07_preview.png",
        "visible": false
    }, {
        "id": 10002,
        "type": "default",
        "hash": "f259979918a51587c636fbc41508ce9b",
        "url": null,
        "filename": "mug-template.psd",
        "mime_type": "image/x-psd",
        "size": 1268210,
        "width": 2700,
        "height": 1380,
        "dpi": 300,
        "status": "ok",
        "created": 1390554376,
        "thumbnail_url": "https://www.printful.com/storage/files/1559/f/f259979918a51587c636fbc41508ce9b_thumb.png",
        "preview_url": "https://www.printful.com/storage/files/1559/f/f259979918a51587c636fbc41508ce9b_preview.png",
        "visible": true
    }, {
        "id": 11802,
        "type": "default",
        "hash": "756a648308bf49d4b763b87cdbd301dc",
        "url": "http://example.com/images/posters/test.pdf",
        "filename": "test.pdf",
        "mime_type": "application/pdf",
        "size": 5846629,
        "width": 5000,
        "height": 6667,
        "dpi": 300,
        "status": "ok",
        "created": 1390551170,
        "thumbnail_url": "https://www.printful.com/storage/files/1559/7/756a648308bf49d4b763b87cdbd301dc_thumb.png",
        "preview_url": "https://www.printful.com/storage/files/1559/7/756a648308bf49d4b763b87cdbd301dc_preview.png",
        "visible": true
    }],
    "paging": {
        "total": 4,
        "offset": 0,
        "limit": 20
    }
}

Add a new file

POST https://api.printful.com/files

Adds a new File to the library by providing URL of the file.

If a file with identical URL already exists, then the original file is returned. If a file does not exist, a new file is created.

Parámetros de entrada
Request body File File data (url parameter is required)
id integer File ID
type string Role of the file in the order
hash string MD5 checksum of the file
url string Source URL where the file is downloaded from
filename string File name
mime_type string MIME type of the file
size integer Size in bytes
width integer Width in pixels
height integer Height in pixels
dpi integer Resolution DPI.
Note: for vector files this may be indicated as only 72dpi, but it doesn't affect print quality since the vector files are resolution independent.
status string File processing status:
ok - file was processed successfuly
waiting - file is being processed
failed - file failed to be processed
created timestamp File creation time
thumbnail_url string Small thumbnail URL
preview_url string Medium preview image URL
visible boolean Show file in the Printfile Library (default true)
Formato de respuesta:
code integer Código del estado de respuesta 200
result File
id integer File ID
type string Role of the file in the order
hash string MD5 checksum of the file
url string Source URL where the file is downloaded from
filename string File name
mime_type string MIME type of the file
size integer Size in bytes
width integer Width in pixels
height integer Height in pixels
dpi integer Resolution DPI.
Note: for vector files this may be indicated as only 72dpi, but it doesn't affect print quality since the vector files are resolution independent.
status string File processing status:
ok - file was processed successfuly
waiting - file is being processed
failed - file failed to be processed
created timestamp File creation time
thumbnail_url string Small thumbnail URL
preview_url string Medium preview image URL
visible boolean Show file in the Printfile Library (default true)
Clave API
Request body
Ejecutar
Añade un archivo a la biblioteca de archivos de impresión, el nombre del archivo se detectará a partir de la URL. Tras la creación, el archivo no se procesa al instante.
Solicitar cuerpo:
{
    "url": "http://www.example.com/files/tshirts/example.psd"
}
Datos de respuesta:
{
    "code": 200,
    "result": {
        "id": 11816,
        "type": "default",
        "hash": null,
        "url": "http://www.example.com/files/tshirts/example.psd",
        "filename": null,
        "mime_type": null,
        "size": 0,
        "width": null,
        "height": null,
        "dpi": null,
        "status": "waiting",
        "created": 1390819101,
        "thumbnail_url": null,
        "preview_url": null,
        "visible": true
    }
}
Añade el archivo a la biblioteca de maquetas y especifica el nombre del archivo manualmente
Solicitar cuerpo:
{
    "type": "preview",
    "url": "http://www.example.com/files/tshirts/example.png",
    "filename": "shirt1.png"
}
Añade un archivo a la biblioteca, pero no lo muestres en la interfaz web
Solicitar cuerpo:
{
    "url": "http://www.example.com/files/tshirts/example.psd",
    "visible": 0
}

Get file information

GET https://api.printful.com/files/{id}

Returns information about the given file
Parámetros de entrada
id integer File ID
Formato de respuesta:
code integer Código del estado de respuesta 200
result File
id integer File ID
type string Role of the file in the order
hash string MD5 checksum of the file
url string Source URL where the file is downloaded from
filename string File name
mime_type string MIME type of the file
size integer Size in bytes
width integer Width in pixels
height integer Height in pixels
dpi integer Resolution DPI.
Note: for vector files this may be indicated as only 72dpi, but it doesn't affect print quality since the vector files are resolution independent.
status string File processing status:
ok - file was processed successfuly
waiting - file is being processed
failed - file failed to be processed
created timestamp File creation time
thumbnail_url string Small thumbnail URL
preview_url string Medium preview image URL
visible boolean Show file in the Printfile Library (default true)
Clave API
id File ID
Ejecutar
Datos de respuesta:
{
    "code": 200,
    "result": {
        "id": 11802,
        "type": "default",
        "hash": "756a648308bf49d4b763b87cdbd301dc",
        "url": "http://example.com/images/posters/test.pdf",
        "filename": "test.pdf",
        "mime_type": "application/pdf",
        "size": 5846629,
        "width": 5000,
        "height": 6667,
        "dpi": 300,
        "status": "ok",
        "created": 1390551170,
        "thumbnail_url": "https://www.printful.com/storage/files/1559/7/756a648308bf49d4b763b87cdbd301dc_thumb.png",
        "preview_url": "https://www.printful.com/storage/files/1559/7/756a648308bf49d4b763b87cdbd301dc_preview.png",
        "visible": true
    }
}

¿Listo para probar Printful?