Sobre la API de Printful

La API de Printful es una RESTful API, que utiliza protocolo HTTP para la comunicación. Los métodos HTTP GET, POST, PUT y DELETE se utilizan para acceder a la API.

Cómo comenzar

Para comenzar a utilizar la API de Printful, sigue estos pasos:
• Ir a Configuración → Tiendas
• Seleccionar la tienda que quieres conectar haciendo clic en Editar
• Haz clic en el botón “Añadir acceso API"
• Introducir la URL de tu página web & obtener clave API única

Clave API

La clave API es una clave secreta única para cada tienda que se utiliza para acceder a la API. Puedes habilitar la API y generar la clave API para tu tienda en la página de configuración de la tienda.

La clave API debe ser secreta, no se debe exponer en códigos de cliente de páginas web públicas.

Autenticación

Algunas solicitudes API (como el Catálogo Printful y Códigos de país) están disponibles sin la clave API, pero para la gran mayoría de solicitudes necesitarás autenticar tu tienda.

Printful usa autenticación básica HTTP para solicitudes API.

Para realizar la autorización, necesitarás añadir el encabezado Autorización con una clave API cifrada Base64 al realizar una solicitud. Así que si la clave API es vv0gtldg-1d7v-qclq:e2vv-lmhg676ak0z1, necesitarás añadir este encabezado a la solicitud API:

Autorización: Básico dnYwZ3RsZGctMWQ3di1xY2xxOmUydnYtbG1oZzY3NmFrMHox

Solicitar punto final

Todas las solicitudes API tienen que enviarse a esta URL:

https://api.printful.com/

También se puede conectar mediante HTTP, pero por razones de seguridad, se recomienda el uso de HTTPS.

Solicitar parámetros

Algunos parámetros obligatorios (como identificadores de objetos) deben incluirse en la ruta URL de la solicitud:

GET /orders/123

Los parámetros adicionales pueden pasarse como variables GET:

GET /orders?offset=10&limit=5

Para solicitudes POST y PUT, se pasa una estructura de datos más compleja como datos cifrados JSON en el cuerpo de solicitud:

POST /orders

{"recipient":{...},"items":[...]}

Cuerpo de respuesta

El cuerpo de respuesta siempre es un objeto JSON que contiene un código del estado de respuesta (idéntico al código del estado HTTP) y el resultado de la acción. Si el código del estado es 200, la acción se considera un éxito.

{"code": 200, //Response status code"result":{//API method return data//...}}

A veces la respuesta incluye información de paginación para permitir la búsqueda de resultados más grandes añadiendo parámetros GET de compensación y límite a la URL solicitada.

{"code": 200, //Response status code"result":[{//Item 11},{//Item 12}]"paging":{"total": 12,  //Total items available"offset": 10, //Items skipped from thebeginning"limit": 20   //Number of items per page}}

Respuesta errónea

Si la llamada API no es exitosa, el código de respuesta no se encuentra en el rango 2xx y el atributo resultado contiene una descripción errónea.

{"code": 404, //Response status code"result":"Item not found" //Error text}

En general, los códigos de respuesta del rango 4xx indican un error resultante de la información dada (por ejemplo, faltaba un parámetro necesario etc.), y los códigos del rango 5xx indican un error con los servidores de Printful.

Marca de tiempo

Todas las marcas de tiempo de la API se devuelven como números enteros en el formato de marca de tiempo UNIX.

¿Listo para probar Printful?