开发者文档

export XXSKU_KEY="sk_live_****************"
export XXSKU_SECRET="********************************"

curl https://api.xxsku.cn/v1/ping \
  -H "Authorization: Bearer $XXSKU_KEY"
# → {"ok": true, "shop": "mianji-flagship", "quota": {"sku_used": 3204}}

from xxsku import Client

client = Client(api_key="sk_live_****************")

spu = client.products.create(
    title="男士休闲衬衫",
    category_id="cate_10231",
    specs=[
        {"name": "颜色", "values": ["白色", "浅蓝", "藏青", "黑色"]},
        {"name": "尺码", "values": ["M", "L", "XL"]},
    ],
    # 不传 skus 时，服务端按 specs 的笛卡尔积自动生成 12 个 SKU
    price_rule={"base": 19900, "step_up": {"XL": 1000}},  # 单位：分
    sku_code_pattern="SKU-{seq:04d}",
)

print(spu["sku_count"])   # → 12
print(spu["skus"][0])
# → {"sku_code": "SKU-0001", "specs": {"颜色": "白色", "尺码": "M"}, "price": 19900}

result = client.skus.update_stock(
    mode="delta",              # absolute | delta
    sync_channels=True,        # 是否推送到已绑定的渠道
    items=[
        {"sku_code": "SKU-0001", "stock": -2},   # delta 模式下表示减 2
        {"sku_code": "SKU-0002", "stock": 50},
    ],
)

print(result["updated"])    # → 2
print(result["synced"])     # → {"taobao": 2, "jd": 2}

# 1. 预览：按标签圈选，整体降价 20%
preview = client.prices.preview(
    filter={"tags": ["秋季上新"]},
    adjust={"type": "percent", "value": -20},
    floor_price=12900,        # 价格下限保护，低于此值的项会被标出
)
print(preview["changes"])     # 逐条列出 原价 → 新价
print(preview["below_floor"]) # 触发下限保护的 SKU

# 2. 确认无误后执行
client.prices.apply(preview_id=preview["id"], sync_channels=True)

channels = client.channels.list()
# → [{"code": "taobao", "status": "active", "pending": 0}, ...]

job = client.channels.sync(
    channel="taobao",
    scope="full",       # full | incremental
    product_ids=["spu_8871", "spu_8872"],
)
print(job["status"])    # → "queued"

import hmac, hashlib

def verify(raw_body: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)

# Flask 示例：注意必须用原始 body，不能先 json.loads 再序列化
@app.post("/xxsku/webhook")
def hook():
    if not verify(request.get_data(), request.headers["X-XXSKU-Signature"], SECRET):
        return "", 401
    event = request.json
    if event["type"] == "stock.changed":
        handle_stock_change(event["data"])
    return "", 204

{
  "request_id": "req_9f31c7a20b",
  "data": {
    "id": "spu_8871",
    "title": "男士休闲衬衫",
    "sku_count": 12,
    "channel_status": { "taobao": "synced", "jd": "pending" },
    "created_at": "2026-09-11T10:24:03Z"
  },
  "meta": { "quota": { "sku_used": 3204, "sku_limit": 30000 } }
}

{
  "request_id": "req_2c81adf903",
  "error": {
    "code": "BelowFloorPrice",
    "message": "3 个 SKU 的改价结果低于价格下限 129.00",
    "retryable": false,
    "details": { "sku_codes": ["SKU-0007", "SKU-0011", "SKU-0012"] }
  }
}