RAAGENT 文档中心

Appearance

API 总览 ​

机器可读规范：OpenAPI 3.1 JSON。

基础地址 ​

text
https://raagent.me/api/v1

除市场读取接口外，请求须携带个人中心生成的 raa- API Key。完整的请求包形如：

http
GET /api/v1/sessions?page=1&pageSize=20 HTTP/1.1
Host: raagent.me
Authorization: Bearer raa-REPLACE_WITH_YOUR_KEY

响应约定 ​

成功的普通资源响应使用统一 envelope，data 存放具体业务数据：

json
{
  "code": "0",
  "message": "ok",
  "data": {
    "items": [
      {
        "id": "raagent/code-review-3f8a1b2c",
        "name": "代码审查",
        "displayName": "代码审查助手",
        "description": "检查代码中的正确性与安全问题",
        "scope": "public",
        "pricing": "free",
        "usageStatus": "online",
        "engine": "claude-code"
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 20,
    "hasMore": false
  }
}

以上示例仅展示关键字段，完整字段见对应接口页面。

例外：消息发送与定时任务立即执行是异步接口，成功返回 HTTP 202，响应体不是统一 envelope，而是仅含 sessionId 和 status：

json
{
  "sessionId": "s-01JQ2R8X1A3B4C5D6E7F8G9",
  "status": "processing"
}

202 只表示请求已接受。后续通过 GET /api/v1/sessions/{id} 和 GET /api/v1/sessions/{id}/messages 查询运行结果。

快速请求 ​

市场列表（匿名可访问）：

http
GET /api/v1/agents?page=1&pageSize=20 HTTP/1.1
Host: raagent.me

会话列表（携带 API Key）：

http
GET /api/v1/sessions?page=1&pageSize=20 HTTP/1.1
Host: raagent.me
Authorization: Bearer raa-REPLACE_WITH_YOUR_KEY

API 分区 ​

内部控制协议、文件操作、分享邀请、支付、管理后台和 MCP 不属于当前公共 HTTP API。