rswag-online/backlog/tasks/task-5 - Add-real-Printful-...

1.6 KiB

id title status assignee created_date updated_date labels dependencies priority
TASK-5 Add real Printful mockup API integration Done
2026-02-18 19:51 2026-02-25 07:28
high

Description

Current upload page uses client-side Canvas compositing with simple template images. When Printful API token is configured, enhance with real Printful Mockup Generator API (POST /mockup-generator/create-task) for photorealistic product previews showing actual garment colors and fabric texture.

Implementation Notes

2026-02-21: Printful client code is DONE and deployed. Blocking issue: API token not scoped to store.

What's done:

  • backend/app/pod/printful_client.py created (catalog, mockups, orders)
  • designs.py updated (Printful mockup path + Pillow fallback)
  • order_service.py refactored (provider-aware routing: printful vs prodigi)
  • Token stored at ~/.secrets/printful_api_token and in Netcup .env
  • Deployed to fungiswag.jeffemmett.com (Pillow fallback working)

Blocking:

  • Token u5WU...R2d returns "This endpoint requires store_id" on mockup/order APIs
  • Need to create a NEW token on developers.printful.com scoped to "Fungi Flows" store
  • Select the store in the "Access" dropdown (not "Account (all stores)")

Once new token is set, just update ~/.secrets/printful_api_token and Netcup .env, rebuild, done.

Printful mockup API v2 integrated. Falls back to Pillow compositing with local templates. Old fungi designs removed, only defectfi-dont-abuse-holes remains.