⬇️ 下载文件

wolai API 访问与修正说明

✅ Agent Browser 成功访问

成功使用 agent-browser 访问了 wolai 开发者文档：https://www.wolai.com/wolai/7FB9PLeqZ1ni9FfD11WuUi

截图已保存：/run/user/0/agent-browser/tmp/screenshots/screenshot-2026-02-25T12-43-13-690Z-awhjfq.png

🔍 API 文档关键发现

通过对真实 API 文档的分析，发现以下重要信息：

1. 正确的 Base URL

文档显示：https://openapi.wolai.com/v1

之前使用的：https://api.wolai.com/v1 ❌

已修正：✅ 所有脚本已更新为正确的 Base URL

2. 核心 API 接口

根据文档，wolai API 主要包括：

Block 操作

POST /blocks - 创建块
GET /blocks/{id} - 获取块信息
GET /blocks/{id}/children - 获取块的子元素

Database 操作

GET /databases/{id} - 获取表格内容
POST /databases/{id}/rows - 插入数据

Token 操作

POST /token - 创建 Token（使用 App ID 和 App Secret）
PUT /token - 刷新 Token

3. 认证方式

Header 格式：

Authorization: Bearer {your_token}
Content-Type: application/json

4. 错误码

文档提供了详细的错误码表：

错误码	原因
17001	缺少参数
17002	参数错误
17003	无效的 token
17004	获取资源失败
17005	资源未找到
17006	服务器内部错误
17007	请求过于频繁
17008	请求体过大
17009	不支持的媒体类型
17010	暂不支持的块类型
17011	权限不足

5. 使用流程

正确的使用步骤：

创建应用：在 wolai 中获取 App ID 和 App Secret
生成 Token：调用 POST /token 接口生成 API Token
添加应用：在需要的页面右上角「页面协作」→「应用权限」→「添加应用」
调用接口：使用 Token 调用 blocks/databases 相关接口

📝 修正内容

已创建修正版脚本

scripts/wolai_api_corrected.py

使用正确的 Base URL: https://openapi.wolai.com/v1
实现文档中的标准接口
支持 Token 创建和刷新
支持 Block 的创建、查询
支持 Database 的查询和插入

关键改动：

# 修正前
self.base_url = "https://api.wolai.com/v1"

# 修正后
self.base_url = "https://openapi.wolai.com/v1"

增强版脚本已同步更新

scripts/wolai_api_enhanced.py 已更新 Base URL

🎯 API 使用示例

1. 创建 Token

python3 scripts/wolai_api_corrected.py \
  --action create-token \
  --app-id YOUR_APP_ID \
  --app-secret YOUR_APP_SECRET

响应：

{
  "success": true,
  "token": "2e6db3fc9bae9e4a5c004162c59c3cfa73ca5f93c61a1b009e219ed454cb37ee"
}

2. 创建块（追加到页面）

python3 scripts/wolai_api_corrected.py \
  --token YOUR_TOKEN \
  --action create-block \
  --parent-id PAGE_OR_BLOCK_ID \
  --content '{"type":"text","content":"Hello wolai!"}'

3. 获取块信息

python3 scripts/wolai_api_corrected.py \
  --token YOUR_TOKEN \
  --action get-block \
  --block-id BLOCK_ID

⚠️ 重要提醒

关于 Personal Space（个人空间）

文档说明：

个人空间：默认赋予应用全部页面操作权限，无需添加应用
团队空间：每个页面都需要在「页面协作」→「应用权限」中添加应用

关于 Token 和 App Secret

App Secret 和 Token 被视为密码，必须保持安全
Token 泄露：调用 PUT /token 刷新
App Secret 泄露：在应用管理页面重置

API 限制

文档提到有接口调用数量限制，但具体数值需要查看「API调用限制」文档。

📊 文档与实际实现的差异

之前版本的问题

❌ Base URL 错误：使用了 api.wolai.com 而不是 openapi.wolai.com
⚠️ 接口假设：基于常规 REST API 推测，未严格遵循文档
✅ 认证方式：Header 中的 Authorization 格式正确

修正后的改进

✅ Base URL 正确：严格遵循文档
✅ 接口标准：实现文档中定义的标准接口
✅ 错误处理：根据错误码表提供具体错误提示
✅ 完整流程：支持 Token 创建、刷新、Block 操作完整链路

🚀 后续建议

测试验证：使用 wolai_api_corrected.py 测试真实 API 调用
更新同步脚本：基于新的 API 创建 sync_conversation_v2.py
完整集成：实现从 Token 创建到 Block 操作的完整工作流
错误处理优化：根据错误码提供更友好的错误提示

📚 参考文件

截图：/run/user/0/agent-browser/tmp/screenshots/screenshot-2026-02-25T12-43-13-690Z-awhjfq.png
修正版 API：scripts/wolai_api_corrected.py
增强版 API：scripts/wolai_api_enhanced.py（已更新 Base URL）
原始 API：scripts/wolai_api.py（供对比）

总结：通过 agent-browser 成功获取真实的 wolai API 文档，发现并修正了 Base URL 错误，创建了符合文档标准的修正版 API 客户端。

📄 API_CORRECTION_NOTES.md