printkk-print-on-demand

PrintKK

PrintKK is a print-on-demand platform that connects sellers with production and fulfillment for custom products — apparel, home decor, accessories, and more. Use the API to automate design creation, product browsing, order placement, and image management.

Base URL: https://api.printkk.com/pkk-openapi

API Scope & Limitations

The API covers internal PrintKK operations only:

• ✅ Image upload & management
• ✅ Design creation & editing
• ✅ Order creation, payment, tracking
• ✅ Product catalog browsing
• ❌ No publishing — you cannot publish designs to external sales channels (Shopify, Etsy, etc.) via API. Publishing must be done through the PrintKK Dashboard.
• ❌ No shop/store management — the API does not expose multi-shop operations. Although PrintKK accounts support multiple stores, the API operates at the account level without shop scoping.
• ❌ No print provider selection — PrintKK uses its own production network. Unlike marketplace-model platforms, there is no API for choosing print providers. Production routing is handled internally by PrintKK.

Authentication

All requests require an Api-Key header.

• Get your key: PrintKK Dashboard → Settings → Api Management
• Keys expire — validity extends 90 days per renewal
• Renewal only allowed when remaining validity ≤ 7 days
• Expired keys cannot be renewed; generate a new one

Api-Key: <your-api-key>

Response Format

All responses follow this structure:

{
  "code": 200,
  "success": true,
  "msg": "OK",
  "data": { ... }
}

Check success field first, not just HTTP status code.

Data Model

Product (catalog)          Image (media library)
  ├── productCode             ├── imageId
  ├── printAreas[]            ├── folderId
  └── specifications[]        └── keywords
         │                         │
         ▼                         ▼
      Design ◄────────────── uses imageId per printArea
        ├── designCode
        ├── designSpecifications[]
        │     └── designSpecificationCode
        └── taskId (async creation)
                │
                ▼
            Order
              ├── orderId
              ├── designSpecificationCode + quantity
              ├── shippingAddress
              └── shippingType priority list
                      │
                      ▼
                  Payment (wallet)