身份验证

安全地创建、使用、轮换和删除 BringSkills API 密钥。

创建账户并进入工作台查看快速开始

总览

BringSkills 使用个人 API 密钥完成请求鉴权。所有受保护请求都需要携带令牌。

令牌格式

令牌统一以 sk-bring- 开头，请像保管密码一样保管它。

创建 API 密钥

在控制台中创建

打开你的登录或创建账户
进入 API 密钥
创建新的 API 密钥
按客户端或环境为密钥命名，方便后续管理
立即复制令牌并保存在安全位置

通过 API 创建

创建密钥请求

bash

curl -X POST https://api.bringskills.com/api/v1/api-keys \
  -H "Authorization: Bearer YOUR_EXISTING_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My New Token",
    "agent_type": "openclaw"
  }'

创建密钥响应

json

{
  "id": "uuid-string",
  "name": "My New Token",
  "key": "sk-bring-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "key_prefix": "sk-bring-xxxx...",
  "agent_type": "openclaw",
  "created_at": "2026-03-13T00:00:00Z",
  "expires_at": null,
  "warning": "请立即保存此令牌，它不会再次显示！"
}

在请求中使用令牌

把令牌放进 Authorization 请求头中，所有需要鉴权的请求都要带上它。

Authorization: Bearer sk-bring-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

请求示例

curl https://api.bringskills.com/api/v1/skills \
  -H "Authorization: Bearer sk-bring-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

多语言示例

Python

python

import requests

headers = {
    "Authorization": "Bearer sk-bring-xxx"
}

response = requests.get(
    "https://api.bringskills.com/api/v1/skills",
    headers=headers
)

JavaScript / Node.js

javascript

const response = await fetch('https://api.bringskills.com/api/v1/skills', {
  headers: {
    'Authorization': 'Bearer sk-bring-xxx'
  }
});

const data = await response.json();

客户端提示建议

为不同客户端或环境使用独立且清晰的 key 命名，有助于后续轮换、排错和审计。

Agent Hint	典型客户端
`OpenClaw`	OpenClaw / Pi connector
`Claude Code`	Anthropic Claude Code
`Cursor`	Cursor IDE
`Codex`	OpenAI Codex
`GitHub Copilot`	GitHub Copilot
`Windsurf`	Codeium Windsurf
`Amazon Q`	Amazon Q Developer
`Aider`	Aider CLI

如果请求支持传入 agent hint，尽量让它与真实调用方保持一致，这样响应适配和日志会更准确。

安全最佳实践

把令牌放进环境变量

优先使用本地 env 文件、密钥管理器或 CI 变量，不要把活跃密钥写死在代码里。

按环境拆分密钥

本地开发、测试和生产分别使用不同的 key，这样撤销权限时影响范围更可控。

不要在浏览器端暴露令牌

前端打包产物、截图和分享代码片段都可能把活跃凭证直接泄露出去。

尽快删除不再使用的密钥

当某个客户端、环境或成员不再需要访问时，立即撤销旧 key，避免长期悬挂风险。

管理现有密钥

列出你的 API 密钥

curl https://api.bringskills.com/api/v1/api-keys \
  -H "Authorization: Bearer sk-bring-xxx"

删除一个 API 密钥

curl -X DELETE https://api.bringskills.com/api/v1/api-keys/tok_abc123 \
  -H "Authorization: Bearer sk-bring-xxx"

删除后立即生效

仍在使用该 key 的运行中客户端会在下一次请求时立刻失败。删除生产密钥前先完成轮换。

返回：快速开始下一步：接入指南