API 参考

AweeClaw 后端 API 为场景市场、开发者中心等提供 RESTful 接口。

基础信息

• Base URL: https://api.aweeclaw.com/api/v1
• 认证方式: JWT Bearer Token
• Content-Type: application/json

认证

所有需要认证的接口需要在请求头中携带 Token：

Authorization: Bearer <token>

接口总览

市场接口

方法	路径	说明	认证
GET	/marketplace/search	搜索场景	否
GET	/marketplace/categories	获取分类	否
GET	/marketplace/:id	场景详情	否
POST	/marketplace/:id/install	安装场景	是
POST	/marketplace/check-updates	检查更新	是
POST	/marketplace/:id/review	评分评价	是

开发者接口

方法	路径	说明	认证
POST	/marketplace/developer/publish	发布场景	是 + 开发者
GET	/marketplace/developer/scenarios	我的场景	是 + 开发者
PUT	/marketplace/developer/:id	更新场景	是 + 开发者
POST	/marketplace/developer/:id/upload-package	上传场景包	是 + 开发者
DELETE	/marketplace/developer/:id	下架场景	是 + 开发者

通用响应格式

{
  "success": true,
  "data": {},
  "message": "操作成功"
}

错误响应：

{
  "success": false,
  "error": {
    "code": "SCENARIO_NOT_FOUND",
    "message": "场景不存在"
  }
}