Documentation Index
Fetch the complete documentation index at: https://docs.legitmark.com/llms.txt
Use this file to discover all available pages before exploring further.
API 密钥认证
Legitmark 使用 API 密钥认证。您的 API 密钥标识您的平台并授权访问 Legitmark 服务。
在所有请求的 Authorization 标头中包含您的 API 密钥：
const headers = {
'Authorization': 'Bearer leo_xxxxxxxxx',
'Content-Type': 'application/json'
};
import { Legitmark } from 'legitmark';
const legitmark = new Legitmark('leo_your_api_key');
安全模型
所有 API 通信使用 API 密钥进行认证。个人信息永远不会在标头、URL 或查询参数中传输，符合严格的数据保护标准。
速率限制
为确保平台稳定性，可能会应用速率限制。如果收到 429 响应，请等待后重试。详情请参阅速率限制。
安全最佳实践
API 密钥安全
- 仅限授权系统访问 API 密钥
- 使用环境变量存储 API 密钥
- 实施密钥轮换程序
- 监控 API 密钥使用异常
请求安全
- 始终使用 HTTPS 进行 API 通信
- 实施请求超时和重试逻辑
- 对所有认证请求使用安全标头
测试认证
验证 API 密钥
使用简单的请求测试您的 API 密钥：
curl -X GET "https://api.legitmark.com/api/v2/categories?active_only=true" \
-H "Authorization: Bearer leo_your_api_key"
使用 SDK 测试
import { Legitmark } from 'legitmark';
const legitmark = new Legitmark('leo_your_api_key', { debug: true });
const { data: categories } = await legitmark.taxonomy.getCategories();
console.log(`连接成功！发现 ${categories.length} 个类别`);
后续步骤
- 查看 分类体系 了解物品分类
- 实施 工作流程 用于服务请求
- 设置 Webhook 用于实时通知
