使用Python调用Printful API创建产品遇400错误求助

已能在Printful网站创建基础连帽衫，尝试用Python调用Printful API创建同款产品，参考官方createSyncProduct文档，但始终收到400错误，提示：该API端点仅适用于基于Manual Order/API平台的Printful店铺。已通过GET请求验证Token有效，也按文档要求包装了sync_product与sync_variants的请求结构，但仍报错。

提供的测试代码：

初始POST请求代码 #

import requests
import json

my_key = "my_token"

headers = {
    "Authorization" : "Bearer "+my_key
}


data = {
            "id": 302079884,
            "external_id": "8136758395169",
            "name": "Unisex Hoodie",
            # "variants": 6,
            "thumbnail_url": "https://cdn.shopify.com/s/files/1/0713/4275/2033/products/unisex-premium-hoodie-black-front-64079acdc1ff0_grande.jpg?v=1678219998",
            "is_ignored": False
        }
data = json.dumps(data)

products = requests.post("https://api.printful.com/store/products",headers=headers,data=data)
print(json.dumps(products.json(),indent=4))

Token验证GET代码 #

import requests
import json

my_key = "my_token"

headers = {
    "Authorization" : "Bearer "+my_key
}

products = requests.get("https://api.printful.com/sync/products",headers=headers)
print(json.dumps(products.json(),indent=4))

修改后的请求数据 #

data = {
    "sync_product": {
        "name": "API product Bella",
        "thumbnail": "https://imagemagick.org/image/wizard.jpg"
    },
    "sync_variants": [
        {
            "retail_price": "21.00",
            "variant_id": 44666144522529,
            "files": [
                {
                    "url": "https://imagemagick.org/image/wizard.jpg"
                },
                {
                    "type": "back",
                    "url": "https://imagemagick.org/image/wizard.jpg"
                }
            ]
        }
    ]
}

报错信息 #

{
    "code": 400,
    "result": "This API endpoint applies only to Printful stores based on the Manual Order / API platform. Find out more at Printful API docs.",
    "error": {
        "reason": "BadRequest",
        "message": "This API endpoint applies only to Printful stores based on the Manual Order / API platform. Find out more at Printful API docs."
    }
}

核心原因 #

你的Printful店铺并非Manual Order/API类型，而是绑定了Shopify、WooCommerce等第三方电商平台的店铺。这类绑定平台的店铺受同步机制限制，无法使用/store/products或/sync/products端点直接创建产品。

具体解决方案 #

1. 确认店铺类型：登录Printful后台，查看店铺的连接方式。如果显示绑定了第三方平台（如Shopify），则无法使用当前API端点。
2. 绑定平台店铺的操作方式：
   • 需先通过你的电商平台（如Shopify）的API创建产品，Printful会自动将该产品同步到你的Printful店铺。
   • 同步完成后，可使用Printful API为该产品添加打印设计、设置库存等操作。
3. 使用API直接创建产品的前提：
   • 若要通过Printful API直接创建产品，需创建一个Manual Order/API类型的独立店铺。这类店铺专门用于API或手动订单管理，无第三方平台绑定限制。
4. Manual店铺的代码修正：
   • 请求头需添加Content-Type: application/json，或直接使用requests的json参数传递数据（无需手动json.dumps），示例：

     # 替换原数据传递部分
     products = requests.post(
         "https://api.printful.com/store/products",
         headers=headers,
         json=data  # 直接传字典，requests会自动处理JSON格式
     )
     

   • 确保请求端点与数据结构匹配：/store/products对应基础产品创建结构，/sync/products对应sync_product包装的结构，不要混用。

内容的提问来源于stack exchange，提问作者PythonKiddieScripterX