🔐 API接口鉴权

Media Saber所有API接口均采用API Key进行身份验证。本指南介绍不同场景下的请求方式及使用规范。

📌 获取API Key

API Key可通过以下路径获取：

1. 进入我的信息页面
2. 切换到"安全配置"标签页
3. 在"API KEY 管理"区域点击"新增"按钮生成新密钥

💡 提示：生成后请妥善保存，建议为不同用途创建独立的API Key

📡 请求方式

以下是两种鉴权传递参数的方式：

1. Query参数方式

GET /api/v1/webhook/demo?apiKey=sk-xxxxxxxxxxxxxxxx HTTP/1.1
Host: your-domain.com
Content-Type: application/json

2. Header请求头方式

GET /api/v1/webhook/demo HTTP/1.1
Host: your-domain.com
Content-Type: application/json
apiKey: sk-xxxxxxxxxxxxxxxx

🛡️ 安全规范

1. 传输安全：如有条件请尽量使用HTTPS传输API Key
2. 存储安全：禁止明文存储在客户端或公共配置文件中
3. 使用原则：
   • 为不同用途创建独立API Key
   • 定期轮换密钥
   • 及时停用不再使用的密钥

🔁 适用范围

以下功能均使用相同鉴权方式：

• Webhook接口（本指南）
• 微信消息通知（详见微信文档）
• MCP服务接口（详见MCP文档）
• 自定义API调用