API.md
REST API
# API Documentation
通过 REST API 以编程方式访问 SkillsMP Skills 数据，支持关键字搜索和 AI 语义搜索。
table_of_contents.md
认证
端点
GET /api/v1/skills/search
使用关键字搜索 Skills
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
| q | string | ✓ | 搜索关键字 |
| page | number | - | 页码 (默认: 1) |
| limit | number | - | 每页数量 (默认: 20, 最大: 100) |
| sortBy | string | - | 排序: stars | recent |
GET /api/v1/skills/ai-search
AI 语义搜索，由 Cloudflare AI 驱动
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
| q | string | ✓ | AI 搜索查询 |
代码示例
关键字搜索
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=SEO" \
-H "Authorization: Bearer sk_live_your_api_key"AI 语义搜索
curl -X GET "https://skillsmp.com/api/v1/skills/ai-search?q=How+to+create+a+web+scraper" \
-H "Authorization: Bearer sk_live_your_api_key"错误处理
API 使用标准 HTTP 状态码，并以 JSON 格式返回错误详情。
| 错误代码 | HTTP | 描述 |
|---|---|---|
| MISSING_API_KEY | 401 | 未提供 API Key |
| INVALID_API_KEY | 401 | API Key 无效 |
| MISSING_QUERY | 400 | 缺少必需的 query 参数 |
| INTERNAL_ERROR | 500 | 服务器内部错误 |
错误响应示例:
json
{
"success": false,
"error": {
"code": "INVALID_API_KEY",
"message": "The provided API key is invalid"
}
}more.md