第三方应用开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
第三方应用开发
服务端API
文档
管理智能文档内容
发布智能文档
发布智能文档
最后更新:2026/07/01

该接口用于发布智能文档。支持首次发布和再次发布(更新版本),发布时可同时设置可见范围。

⚠️ 此接口内部包含异步任务处理,耗时较长(通常 3-8 秒),建议调用方配置超时时间为 10 秒以上。

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartdoc/publish?access_token=ACCESS_TOKEN

请求包体

{
    "docid": "DOCID",
    "publish_range": 1,
    "auth_list": [
        {
            "type": 1,
            "userid": "USERID"
        },
        {
            "type": 2,
            "departmentid": 1
        }
    ]
}


参数说明

参数类型是否必须说明
docidstring智能文档的文档 id,可通过 新建文档 接口创建
publish_rangeuint32发布可见范围。1:企业内可见;3:企业内外可见;4:指定成员可见。不传时默认为1(企业内可见)
auth_listobj[]条件必填指定可见成员列表,publish_range为4时必填
auth_list.typeuint32成员类型。1:企业成员;2:部门
auth_list.useridstring条件必填企业成员的userid,type为1时必填
auth_list.departmentiduint64条件必填部门id,type为2时必填


权限说明

  • 自建应用需配置到"可调用应用"列表中的应用secret所获取的accesstoken来调用
  • 第三方应用需具有"文档"权限
  • 代开发自建应用需具有"文档"权限

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "share_code": "SHARE_CODE",
    "publish_url": "PUBLISH_URL",
    "version": 1,
    "publish_time": 1710000000,
    "publish_doc_title": "PUBLISH_DOC_TITLE"
}

参数说明

参数类型说明
errcodeint32错误码
errmsgstring错误码说明
share_codestring分享码
publish_urlstring发布页访问链接,格式为 https://doc.weixin.qq.com/smartdoc/p/{share_code}
versionuint64发布版本号
publish_timeuint64发布时间戳(秒)
publish_doc_titlestring发布页标题


错误码说明

错误码说明
640008权限不足,调用者无管理权限
640012auth_list中userid无效,成员不在企业中
640013auth_list中departmentid无效
640017企业未开启API功能,需管理员开启
640018企业管理员未授予API编辑权限
640027参数错误,如docid不合法、publish_range无效等
640032被企业管理端权限限制
640054docid不是智能文档类型
上一篇更新数据表
下一篇取消发布智能文档
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
客户端API
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
数据API
更新日志
联系我们