用途：面向 Printify 按需印刷平台的开发参考与集成工具，覆盖 V1 REST 与 V2 json:api 目录运费查询。核心流程为：从目录选蓝本、选印刷商、将图案放置到占位符生成产品，再提交由服务商履约发货的订单。
主要能力：文档包含完整端点目录（请求体、查询参数、分页、限流、错误码、OAuth）、对象字段与枚举（订单状态、配送方式、图片定位规则）、Webhook 事件主题、载荷、重试、HMAC 校验与接收器骨架。资源覆盖店铺、目录、上传（媒体库）、产品、订单（提交、运费计算、转生产、取消、售后请求）、个性化与 Webhook。
使用方式：基础地址为 https://api.printify.com/v1/...，Printful Enterprise 品牌为 https://enterprise.printful.com/api/pfy/public/v1/...。使用 Authorization: Bearer {token}，个人令牌有效期 1 年且仅显示一次，OAuth 令牌每 6 小时过期需刷新；每个请求必带 User-Agent。无 CORS，须从服务端调用。几乎每个路径都需要 {shop_id}，可从 GET /v1/shops.json 获取。附带无依赖的 Python CLI（仅标准库），自动添加认证与 User-Agent、对 429/502/503 退避重试、遍历分页；令牌查找顺序为 PRINTIFY_API_TOKEN 环境变量，其次 macOS 钥匙串。示例：scripts/printify auth set、scripts/printify shops、scripts/printify get /v1/catalog/blueprints/6/print_providers.json、scripts/printify post /v1/shops/5432/orders.json -f order.json。退出码 2 表示 API 返回 4xx/5xx 并打印错误体。
适用场景：构建电商或平台侧 Printify 集成、同步目录与产品、下单与查询物流、接收订单状态 Webhook。
限制：沙箱代理读取钥匙串需网络访问；新店铺默认 24 小时后自动转生产；取消仅在订单挂起或未付款时可行，之后需用售后接口；订单列表分页上限为 10；限流为每账户每分钟 600 次、目录 100 次、每 30 分钟 200 次发布；金额为整数分；该技能与 Printify 无关联，内容源自公开文档，端点、错误码与限额可能变化，关键用途请以官方文档核实。