# 接口点数资源规则

自 2026年7月1日起,CJ API 访问控制将从"每日调用次数"模式切换为**"点数消费"**模式。每次调用 API 接口将消耗一定数量的点数,点数耗尽时接口调用将被拒绝。

# 每日可用总点数

每位用户的每日可用点数由以下来源组成:

总点数 = 基础点数 + 成交金额转换

来源 说明 重置周期
基础点数 所有用户每日 50,000 点 每日0点重置(UTC 0时区)
成交金额转换 近期成交金额按 100点/美金 换算 每日重新计算

# 成交金额转换规则

  • 换算比例:1美金 = 100点
  • 计算公式:最近3个月成交金额的最高值 × 100
  • 每日重新计算

# 接口消耗点数

每次调用以下接口将扣减对应点数。未列出的接口不消耗点数

接口路径 每次调用消耗点数
/product/listV2 50
/product/list 50
/product/query 10
/product/variant/query 10
/product/variant/queryByVid 10
/product/stock/queryByVid 10
/product/stock/queryBySku 10
/product/stock/privateInventory/querySpuPage 10
/product/stock/privateInventory/querySkuListByProductId 10
/product/stock/privateInventory/querySkuDetailPage 10
/product/stock/privateInventory/querySkuDetailListBySku 10
/product/stock/privateInventory/querySkuFlowByCondition 10
/storehouseCenterWeb/syncStorehouseVideoRequests 10
/product/stock/getInventoryByPid 10
/logistic/freightCalculate 10
/logistic/freightCalculateTip 10
/logistic/partnerFreightCalculate 10
/logistic/getSupplierLogisticsTemplate 10
/webhook/product/subscribe 10
/webhook/product/unsubscribe 10

# 扣减优先级

当接口调用消耗点数时,系统按以下优先级扣减:

  1. 基础点数优先扣减
  2. 成交金额转换点数

# 点数不足

当您的每日可用点数不足以支付本次接口调用时,系统将返回 HTTP 429 错误:

{
  "code": 429,
  "result": false,
  "message": "Insufficient API points. Used today: 50000, Remaining: 0, Required: 10",
  "pointsInfo": {
    "usedToday": 50000,
    "remaining": 0,
    "total": 50000
  }
}

# 点数信息查询

每次 API 调用的响应中都将包含 pointsInfo 字段,展示当日已使用点数和剩余点数:

{
  "code": 200,
  "data": { ... },
  "pointsInfo": {
    "usedToday": 1250,
    "remaining": 48750,
    "total": 50000
  }
}

# 账号冻结规则

为维护平台稳定性和安全性,以下不活跃规则同时生效:

  • 如果您的 API 账号连续 30天 未进行任何 API 调用,账号将被自动冻结,API 访问将被暂停
  • 账号冻结前会发送通知邮件
  • 如需解冻账号,请联系 CJ 客服处理

# 生效时间

  • 2026年6月1日起,所有用户将全面启用点数限流规则
  • 在此之前,现有QPS限流和每日调用次数限制保持不变

# 联系我们

如有疑问,请通过以下方式联系:

  • 邮件:developer@cjdropshipping.com