逻辑删除商品#

通过将商品状态设置为 invalid，从目录中移除该商品，而不会永久删除商品。重复删除请求是安全的：删除已经是 invalid 的商品会返回其当前状态。

提供 productId 或 sku 中的恰好一个。

http

DELETE https://sdkapi.ideal.house/product-import/products?shopId=<SHOP_ID>&productId=<PRODUCT_ID>

或：

http

DELETE https://sdkapi.ideal.house/product-import/products?shopId=<SHOP_ID>&sku=<SKU>

cURL 示例#

bash

curl --request DELETE \
  'https://sdkapi.ideal.house/product-import/products?shopId=shop_123&sku=SKU-10001' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Client-Secret: <YOUR_CLIENT_SECRET>'

响应#

成功的请求将返回 200 OK 以及完整的商品对象，其中 status 设置为 invalid：

json

{
  "id": "product_123",
  "shopId": "shop_123",
  "sku": "SKU-10001",
  "name": "Large Gold Wall Mirror",
  "status": "invalid",
  "createdAt": "2026-07-21T06:30:00.000Z",
  "updatedAt": "2026-07-21T07:15:00.000Z"
}

逻辑删除的商品不会被“列出商品”端点返回。如果后续通过批次导入 API 提交相同的 SKU，现有商品记录可能会被更新，而不是创建第二个商品。