认证与密钥

申请条件

API 是否开放、累计实付充值门槛和每分钟限流由后台配置。门槛可以是 0 元；如果账号未达到门槛，申请时会返回还差多少金额。只有客户账号可以申请和使用密钥。

在“开发者服务 → API 接入”中可以看到：服务状态、累计充值、门槛、剩余金额、限流值和当前密钥状态。

创建密钥

创建或轮换成功时，接口只返回一次完整明文；页面刷新后只显示掩码和末四位。请立即复制到密码管理器：

Authorization: Bearer 你的API密钥

密钥一旦泄露，立即回到控制台轮换或停用。轮换会让旧密钥立即失效，正在执行的请求可能收到 INVALID_API_KEY。

两种请求头

推荐使用 Bearer：

curl https://cdn.1888.news/api/open/v1/account \
  -H "Authorization: Bearer 你的API密钥"

也可以使用：

curl https://cdn.1888.news/api/open/v1/account \
  -H "X-API-Key: 你的API密钥"

不要同时传两个不同的值；如果 Authorization 和 X-API-Key 不一致，会返回 AMBIGUOUS_API_KEY。

Node.js 调用封装

const baseUrl = 'https://cdn.1888.news/api/open/v1';
const apiKey = process.env.KUNTT_API_KEY;

async function kuntt(path, options = {}) {
  const response = await fetch(`${baseUrl}${path}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
      ...(options.headers || {})
    }
  });
  const body = await response.json();
  if (!response.ok || body.code !== 0) {
    throw new Error(`${body.code}: ${body.msg} (requestId=${body.requestId})`);
  }
  return body.data;
}

const account = await kuntt('/account');
console.log(account.balanceCents);

密钥存储

本地开发使用环境变量；生产环境使用云密钥管理、Docker secret 或服务器权限隔离。日志中只能打印密钥前缀和末四位，不能打印完整值。

下一步：阅读 账户与套餐。