get_doc_content API

获取企业微信文档的完整内容数据，以 Markdown 格式返回。该接口采用异步轮询机制：首次调用无需传 task_id，接口会返回 task_id；若 task_done 为 false，需携带该 task_id 再次调用，直到 task_done 为 true 时返回完整内容。

技能定义

{
    "name": "get_doc_content",
    "description": "获取企业微信文档的完整内容数据，以 Markdown 格式返回。该接口采用异步轮询机制：首次调用无需传 task_id，接口会返回 task_id；若 task_done 为 false，需携带该 task_id 再次调用，直到 task_done 为 true 时返回完整内容。",
    "inputSchema": {
        "properties": {
            "docid": {
                "description": "文档的 docid，与 url 二选一传入",
                "title": "Doc ID",
                "type": "string"
            },
            "url": {
                "description": "文档的访问链接，与 docid 二选一传入",
                "title": "URL",
                "type": "string"
            },
            "type": {
                "description": "内容返回格式。2: Markdown 格式",
                "enum": [2],
                "title": "Type",
                "type": "integer"
            },
            "task_id": {
                "description": "任务 ID，用于异步轮询。初次调用时不填，后续轮询时填写上次返回的 task_id",
                "title": "Task ID",
                "type": "string"
            }
        },
        "oneOf": [
            { "required": ["docid", "type"] },
            { "required": ["url", "type"] }
        ],
        "title": "get_doc_contentArguments",
        "type": "object"
    }
}

参数说明

| 参数 | 类型 | 必填 | 说明 | |---|---|---|---| | docid | string | 与 url 二选一 | 文档的 docid | | url | string | 与 docid 二选一 | 文档的访问链接 | | type | integer | 是 | 内容返回格式，固定传 2（Markdown 格式） | | task_id | string | 否 | 任务 ID，初次调用不填，后续轮询时填写上次返回的 task_id |

异步轮询机制

1. 首次调用：传入 docid/url 和 type: 2，不传 task_id 2. 检查响应：若 task_done 为 false，记录返回的 task_id 3. 轮询调用：携带 task_id 再次调用，直到 task_done 为 true 4. 获取内容：当 task_done 为 true 时，content 字段包含完整的 Markdown 内容

请求示例

// 首次调用
{
    "docid": "DOCID",
    "type": 2
}
// 轮询调用
{
    "docid": "DOCID",
    "type": 2,
    "task_id": "xxx"
}

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "content": "# 文档标题\n\n文档正文内容...",
    "task_id": "xxxxx",
    "task_done": true
}