基础 URL
http://localhost:3001/api💡 提示:所有 API 请求都需要添加此前缀
搜索 API
GET
/api/search/agents搜索 Agent
查询参数
qstring必填搜索关键词pagenumber页码,默认 1limitnumber每页数量,默认 20GET /api/search/agents?q=ai+agent&page=1&limit=20
GET
/api/search/skills搜索 Skills
查询参数
qstring必填搜索关键词pagenumber页码,默认 1limitnumber每页数量,默认 20GET /api/search/skills?q=python&page=1&limit=20
POST
/api/search/unified统一搜索(Agents + Skills)
请求体
qstring必填搜索关键词pagenumber页码,默认 1limitnumber每页数量,默认 20POST /api/search/unified
{
"q": "ai agent",
"page": 1,
"limit": 20
}GET
/api/search/recommend-skills推荐相关 Skills
查询参数
qstring必填搜索关键词limitnumber推荐数量,默认 5GET /api/search/recommend-skills?q=chatbot&limit=5
爬虫管理
POST
/api/search/crawl需要认证手动触发爬虫任务
POST /api/search/crawl
Headers: {
"Authorization": "Bearer <token>"
}GET
/api/search/crawler-status获取爬虫状态
GET /api/search/crawler-status
用户认证
POST
/api/auth/register用户注册
请求体
emailstring必填邮箱地址passwordstring必填密码namestring用户名POST /api/auth/register
{
"email": "user@example.com",
"password": "password123",
"name": "John Doe"
}POST
/api/auth/login用户登录
请求体
emailstring必填邮箱地址passwordstring必填密码POST /api/auth/login
{
"email": "user@example.com",
"password": "password123"
}GET
/api/auth/me需要认证获取当前用户信息
GET /api/auth/me
Headers: {
"Authorization": "Bearer <token>"
}项目管理
GET
/api/projects需要认证获取用户项目列表
GET /api/projects
Headers: {
"Authorization": "Bearer <token>"
}POST
/api/projects需要认证创建新项目
请求体
namestring必填项目名称descriptionstring项目描述POST /api/projects
Headers: {
"Authorization": "Bearer <token>"
}
{
"name": "My AI Project",
"description": "Building an AI agent"
}