# 接口点数资源规则
自 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 |
# 扣减优先级
当接口调用消耗点数时,系统按以下优先级扣减:
- 基础点数优先扣减
- 成交金额转换点数
# 点数不足
当您的每日可用点数不足以支付本次接口调用时,系统将返回 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