📄 API_INFO_REQUEST.md

⬇️ 下载文件

wolai API 文档信息提取指南

如何获取文档内容

请登录 https://www.wolai.com/wolai/7FB9PLeqZ1ni9FfD11WuUi 后,复制以下内容:


1. 基础信息

API 基础 URL
(如:https://api.wolai.com/v1 或类似)

认证方式
如何传递 API token?例如:

  • Header: Authorization: Bearer YOUR_TOKEN
  • Header: Authorization: Token YOUR_TOKEN
  • 其他方式:_________

2. 页面操作 API

创建页面

端点

POST _________

请求体格式

{
  "字段1": "说明",
  "字段2": "说明",
  "content": "内容格式"
}

响应格式

{
  "id": "页面ID",
  "其他字段": "___"
}

更新页面内容

端点

PATCH/PUT _________/{page_id}

请求体格式

{
  "content": "内容格式"
}

注意:是追加还是覆盖原有内容?_________


获取页面详情

端点

GET _________/{page_id}

响应格式

{
  "id": "页面ID",
  "title": "标题",
  "content": "___"
}

搜索页面

端点

POST _________

请求参数

{
  "query": "搜索词",
  "其他参数": "___"
}

3. 内容块(Block)格式

wolai 如何组织页面内容?例如:

文本块

{
  "type": "text",
  "content": "文本内容"
}

标题块

{
  "type": "heading_1/2/3",
  "content": "标题内容"
}

列表块

{
  "type": "bulleted_list",
  "content": ["项目1", "项目2"]
}

代码块

{
  "type": "code",
  "language": "python",
  "content": "代码"
}

(请提供实际支持的块类型和格式)


4. 常见 HTTP 状态码

  • 200 - 成功
  • 201 - 创建成功
  • 400 - 请求格式错误
  • 401 - 认证失败
  • 403 - 权限不足
  • 404 - 页面不存在
  • 429 - 请求过于频繁
  • 500 - 服务器错误

(请提供 wolai 实际使用的状态码)


5. 错误响应格式

失败时返回的格式:

{
  "error": {
    "code": "错误代码",
    "message": "错误描述"
  }
}

或:

{
  "code": "___",
  "message": "___"
}

6. API 限制

  • 频率限制:每分钟/小时最多 ___ 次请求
  • 内容限制:单次最多 ___ 个块
  • 其他限制:_________

7. 特殊说明

是否有特殊要求或注意事项?


获取方式

有以下两种便捷方式:

方式A:复制粘贴

直接在 wolai 页面选中并复制相关章节的内容,然后粘贴给我。

方式B:截图

截图 API 文档的关键部分(特别是请求格式、响应格式、端点路径),我会手动提取信息。


最少需要的信息

如果实在不方便,至少提供以下核心信息:

  1. ✅ API 基础 URL
  2. ✅ 如何传递 token(认证头格式)
  3. ✅ 创建页面的端点和请求格式
  4. ✅ 更新页面的端点和请求格式
  5. ✅ content/blocks 的数据结构

收到这些信息后,我会完全按照官方文档重新实现所有 API 调用,确保 100% 兼容!