API 文档

通过 REST API 以编程方式访问 SkillsMP Skills 数据，支持关键字搜索、分类和职业筛选。

table_of_contents.md

认证

端点

GET /api/v1/skills/search

使用关键字搜索 Skills

参数	类型	必需	描述
q	string	✓	搜索关键字
page	number	-	页码 (默认: 1)
limit	number	-	每页数量 (默认: 20, 最大: 100)
sortBy	string	-	排序方式: stars \| recent（默认: recent）
category	string	-	按分类过滤，传分类 slug（如 data-ai、devops）。
occupation	string	-	按 SOC 职业过滤，传职业 slug（如 software-developers）。

速率限制

*匿名访问（无需 API Key）：50 次/天，10 次/分钟 — 仅限关键字搜索
*登录用户（使用 API Key）：500 次/天，30 次/分钟 — 关键字搜索
*不支持通配符搜索（如 *）

每个 API 响应都包含以下头信息以帮助你追踪配额用量：

Header	描述
X-RateLimit-Daily-Limit	每日请求上限
X-RateLimit-Daily-Remaining	当日剩余可用次数

代码示例

关键字搜索

curl -X GET "https://skillsmp.com/api/v1/skills/search?q=SEO" \
  -H "Authorization: Bearer sk_live_your_api_key"

按职业（occupation）筛选示例

curl -X GET "https://skillsmp.com/api/v1/skills/search?q=automation&occupation=software-developers&sortBy=stars" \
  -H "Authorization: Bearer sk_live_your_api_key"

错误处理

API 使用标准 HTTP 状态码，并以 JSON 格式返回错误详情。

错误代码	HTTP	描述
INVALID_API_KEY	401	API Key 无效
MISSING_QUERY	400	缺少必需的 query 参数
INVALID_OCCUPATION	400	未知的职业 slug
DAILY_QUOTA_EXCEEDED	429	超过每日 API 调用限制
INTERNAL_ERROR	500	服务器内部错误

错误响应示例:

json

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid"
  }
}

more.md

返回文档首页