# 微盘 API 实测记录（2026-06-22）

## 已验证可用

| 接口 | 端点 | 备注 |
|------|------|------|
| 创建空间 | `POST /wedrive/space_create` | 返回 `{"spaceid": "s.{corpid}.{suffix}", "errcode": 0}` |
| 获取空间信息 | `POST /wedrive/space_info` | 传 `{"spaceid": "..."}` |
| 获取文件列表 | `POST /wedrive/file_list` | 必须同时传 spaceid 和 fatherid（根目录时等于 spaceid） |
| 上传文件 | `POST /wedrive/file_upload` | 返回 `{"fileid": "s.{corpid}.{suffix}_f.{ts}", "errcode": 0}` |
| 添加成员 | `POST /wedrive/space_acl_add` | `auth_info[].type=1` 表个人，`auth=7` 为管理员 |
| 空间安全设置 | `POST /wedrive/space_setting` | |

## 不存在（404）

- `/wedrive/space_list`
- `/wedrive/space/list`
- `/wedoc/doc_list`
- `/wedoc/document/list`

## 错误码

| errcode | 含义 | 触发条件 |
|---------|------|---------|
| 640001 | space not exist | spaceid 格式不对 |
| 640008 | permission deny | 应用未被加入该空间 |
| 640020 | Invalid auth type | `space_acl_add` 缺少 `auth` 字段 |
| 60011 | no privilege | 应用没有通讯录/部门访问权限 |

## spaceid 发现方法

唯一可行方式：从企微分享的空间链接中提取。

示例 URL：
```
https://drive.weixin.qq.com/webdisk/index?t=home#/cgi/ssr/space/1/s.1970326072993951.714786042QBf/all
```

spaceid = `s.1970326072993951.714786042QBf`

## API 创建的空间不可见

API 创建的空间默认只有应用自己是管理员。用户和其他人（包括企业管理员）看不到。必须 `space_acl_add` 添加成员后才在前端可见。

验证：
- 创建空间 → 用户前端看不到
- `space_acl_add` 加 TuKeXin 为管理员 → 用户前端可看到