递归获取所有部门

部门接口只返回指定节点的直属子部门。获取完整组织树时，需要从根部门开始，对每个节点分页查询并继续遍历。

调用顺序

1. 调用查询部门详情，使用 $root 获取根部门。
2. 调用查询子部门列表。
3. 按 offset 和 limit 读取当前节点的全部直属子部门。
4. 将子部门加入待处理队列，直到队列为空。

Python 示例

from collections import deque
import requests

API_BASE = "https://alimail-cn.aliyuncs.com"


def list_all_departments(access_token: str) -> list[dict]:
    headers = {"Authorization": f"Bearer {access_token}"}
    root = requests.get(
        f"{API_BASE}/v2/departments/$root",
        headers=headers,
        timeout=15,
    )
    root.raise_for_status()

    result = [root.json()]
    pending = deque([root.json()["id"]])
    while pending:
        parent_id = pending.popleft()
        offset = 0
        while True:
            response = requests.get(
                f"{API_BASE}/v2/departments/{parent_id}/departments",
                headers=headers,
                params={"offset": offset, "limit": 100},
                timeout=15,
            )
            response.raise_for_status()
            payload = response.json()
            children = payload.get("departments", [])
            result.extend(children)
            pending.extend(item["id"] for item in children)
            offset += len(children)
            if offset >= payload.get("total", 0) or not children:
                break
    return result

大型组织应增加重试、速率限制和断点记录，并使用部门 ID 去重，避免异常数据导致重复遍历。

参考：原始示例。