Desarrolle con la API de PrintKK
Comience con la autenticación por firma, luego implemente la carga de imágenes, la creación de diseños, la creación de pedidos y el procesamiento de pagos mediante endpoints REST.
Capacidades principales de la API
Céntrese en el flujo de producción esencial, desde los activos hasta el pago, basado en los grupos de endpoints documentados.
Firma y autenticación
Utilice las especificaciones de firma y autenticación para asegurar cada solicitud y controlar el acceso a sus operaciones de API.
Cargar imágenes
Cargue activos de diseño a través de los endpoints de imagen y prepare los archivos para la generación de diseños posterior.
Crear diseños
Cree datos de diseño con los endpoints de diseño y organice los parámetros requeridos para una salida lista para producción.
Crear y pagar pedidos
Envíe payloads de pedido y complete los pagos a través de los endpoints de pedido para cerrar el flujo de transacción.
Flujo de integración de la API
Desde la primera llamada autenticada hasta el pedido pagado, esta ruta de cuatro etapas refleja cómo se agrupan nuestras APIs en la documentación: acceso seguro, activos de imagen, diseños imprimibles y luego checkout y pago. Trate cada etapa como un punto de control para que su backend sea predecible y fácil de depurar.
Configurar firma y autenticación
Lea los capítulos sobre firma y autenticación, emita o importe las credenciales que necesita su entorno e implemente la firma exactamente como se especifica. Envíe algunas solicitudes de prueba de bajo riesgo y confirme que recibe respuestas exitosas antes de proceder con las cargas -- cuando la autenticación es sólida, los errores posteriores casi siempre apuntan a la estructura del payload en lugar de misteriosos errores 401.
Cargar las imágenes que necesitan sus productos
Utilice los endpoints de imagen para cargar logotipos, obras de arte u otros archivos que requiera su integración. Almacene cada identificador devuelto en la respuesta de la API para poder pasar esos valores a las solicitudes de diseño posteriores, tal como se muestra en los ejemplos de solicitud.
Crear y persistir registros de diseño
Llame a los endpoints de diseño para crear registros de diseño que combinen productos, ubicaciones y referencias de imagen del paso anterior. Conserve los identificadores de diseño devueltos en su sistema para que los payloads de los pedidos puedan hacer referencia a ellos, como se describe en la sección Pedido de la documentación.
Enviar el pedido y finalizar el pago
Envíe pedidos a través de los endpoints de pedido utilizando los identificadores de diseño almacenados. Complete el pago siguiendo los pasos documentados para los endpoints relacionados con el pago. Las respuestas, códigos de estado y cuerpos de error en la documentación son autoritativos -- no confíe en comportamientos que no estén descritos allí.
Más allá de la ruta de integración principal
La documentación oficial de la API también agrupa Producto, General, FAQ y Changelog junto con Autenticación, Imagen, Diseño y Pedido. Utilice estas secciones cuando necesite datos de catálogo, utilidades compartidas o historial de versiones que el flujo principal no cubre por sí solo.
-
Producto
Los endpoints de Producto describen cómo consultar artículos del catálogo, variantes y opciones que se combinan con diseños y pedidos. Consúltelos cuando deba resolver ID de producto o atributos antes de construir un payload.
-
General
La sección General cubre utilidades y solicitudes transversales que acompañan a las llamadas de imagen, diseño y pedido. Consulte la referencia cuando necesite operaciones auxiliares documentadas allí.
-
FAQ y Changelog
Lea las preguntas frecuentes para cuestiones comunes de integración y utilice el Changelog para rastrear actualizaciones de la API, adiciones y cualquier cambio incompatible a lo largo del tiempo.
Casos de uso comunes de la API
Patrones de implementación típicos basados en capacidades de imagen, diseño y pedido.
Pipeline de diseño automatizado
Cargue imágenes por lotes y genere diseños programáticamente para acelerar la producción de contenido.
Servicio de envío de pedidos
Construya un servicio backend que convierta datos de checkout en solicitudes de pedido estandarizadas.
Flujo de finalización de pago
Conecte los endpoints de creación de pedidos y pago en una secuencia de transacción controlada con un manejo claro de estados.
Recursos para equipos
Utilice la documentación y los canales de soporte para acelerar el desarrollo y el despliegue.
Documentación para desarrolladores
Revise los grupos de endpoints, detalles de autenticación y ejemplos de payload para operaciones de imagen, diseño y pedido.
Abrir documentaciónSoporte técnico
Contacte al equipo de PrintKK para preguntas de implementación y solución de problemas de integración.
Preguntas frecuentes de la API
¿Qué debemos implementar primero?
Comience con la firma y autenticación para que cada solicitud posterior de imagen, diseño y pedido sea verificable y segura.
¿Qué operaciones principales son compatibles?
Las operaciones principales documentadas son la carga de imágenes, la creación de diseños, la creación de pedidos y el pago de pedidos.
¿Cómo debemos estructurar la secuencia de llamadas?
Utilice un flujo lineal: autenticar solicitudes, cargar imágenes, crear diseños, crear pedidos y luego completar el pago.
¿Dónde podemos encontrar detalles de las solicitudes?
Consulte la documentación de la API para obtener parámetros de endpoints, ejemplos de solicitudes y notas de implementación específicas de cada sección.
Comience la integración hoy mismo
Abra la documentación de la API para ver las reglas de firma, los parámetros de los endpoints y ejemplos de solicitudes para cada capacidad.
