## 所需权限
<table> <thead> <tr> <td><p><b>所需权限</b></p></td> <td><p><b>资源</b></p></td> <td><p><b>Scope</b></p></td> <td><p><b>资源服务</b></p></td> </tr> </thead> <tbody> <tr> <td><p>用户同步配置读取（读取）</p></td> <td><p>directory-sync-config</p></td> <td><p>admin.v1.directory-sync-config.read</p></td> <td><p>qwenwork-biz-service</p></td> </tr> </tbody> </table>

```
HELPCODEESCAPE-http
GET /api/openapi/v1/directory-sync/sources
```

## 公共请求头
适用《通过 API 配置 QwenWork 管理后台》的"认证与请求头"章节：`Authorization` 必填，`X-Request-Id` 可选；当前接口所需 Scope 见本页。

`Idempotency-Key` 是否适用及必填性以本页请求参数为准，不能用追踪标识替代幂等键。

## 请求参数
无请求参数。

## 请求示例
将 \<BASE_URL\> 替换为企业部署的千问办公 API 服务地址，并填写实际参数。示例中的占位值不能直接用于请求。

```
HELPCODEESCAPE-curl
curl --request GET \
  --url '<BASE_URL>/api/openapi/v1/directory-sync/sources' \
  --header 'Authorization: Bearer <API_KEY>'
```

## 响应状态表
<table> <thead> <tr> <td><p><b>HTTP 状态码</b></p></td> <td><p><b>触发条件</b></p></td> <td><p><b>响应结构引用</b></p></td> <td><p><b>客户端处理建议</b></p></td> </tr> </thead> <tbody> <tr> <td><p>200</p></td> <td><p>请求成功</p></td> <td><p>见本文"响应结果"</p></td> <td><p>读取响应结果。</p></td> </tr> <tr> <td><p>default</p></td> <td><p>未单独列出的认证、授权、校验或依赖错误</p></td> <td><p>见《通过 API 配置 QwenWork 管理后台》的"通用错误"结构</p></td> <td><p>按状态与 code 处理；写操作重试前核实结果及幂等要求。</p></td> </tr> </tbody> </table>

## 响应结果
Content-Type: application/json
<table> <thead> <tr> <td><p><b>名称</b></p></td> <td><p><b>类型</b></p></td> <td><p><b>必填</b></p></td> <td><p><b>说明</b></p></td> <td><p><b>示例</b></p></td> </tr> </thead> <tbody> <tr> <td><p>sources</p></td> <td><p>array\&lt;object\&gt;</p></td> <td><p>是</p></td> <td><p>数据源列表</p></td> <td><p><code>-</code></p></td> </tr> </tbody> </table>

### sources\[\]

<table> <thead> <tr> <td><p><b>字段</b></p></td> <td><p><b>类型</b></p></td> <td><p><b>必填</b></p></td> <td><p><b>说明</b></p></td> </tr> </thead> <tbody> <tr> <td><p>config_revision</p></td> <td><p>integer · int64</p></td> <td><p>是</p></td> <td><p>配置版本号</p></td> </tr> <tr> <td><p>connection_status</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>连接状态</p></td> </tr> <tr> <td><p>created_at</p></td> <td><p>string · date-time</p></td> <td><p>是</p></td> <td><p>创建时间</p></td> </tr> <tr> <td><p>created_by_email</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>创建人邮箱</p></td> </tr> <tr> <td><p>created_by_name</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>创建人</p></td> </tr> <tr> <td><p>credential_configured</p></td> <td><p>boolean</p></td> <td><p>是</p></td> <td><p>是否已配置凭据</p></td> </tr> <tr> <td><p>default_seat</p></td> <td><p>boolean</p></td> <td><p>是</p></td> <td><p>新用户默认申请席位</p></td> </tr> <tr> <td><p>deletion_alert_email</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>告警邮箱</p></td> </tr> <tr> <td><p>deletion_alert_enabled</p></td> <td><p>boolean</p></td> <td><p>是</p></td> <td><p>删除告警</p></td> </tr> <tr> <td><p>deletion_alert_threshold</p></td> <td><p>integer · int64</p></td> <td><p>是</p></td> <td><p>删除告警阈值</p></td> </tr> <tr> <td><p>deletion_policy</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>离职处理</p></td> </tr> <tr> <td><p>external_id_field</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>第三方用户 ID 映射字段</p></td> </tr> <tr> <td><p>external_id_field_locked</p></td> <td><p>boolean</p></td> <td><p>是</p></td> <td><p>第三方用户 ID 映射是否已锁定</p></td> </tr> <tr> <td><p>id</p></td> <td><p>string · uuid</p></td> <td><p>是</p></td> <td><p>数据源 ID</p></td> </tr> <tr> <td><p>last_activity_at</p></td> <td><p>string · date-time</p></td> <td><p>否</p></td> <td><p>最近活动时间</p></td> </tr> <tr> <td><p>last_connected_at</p></td> <td><p>string · date-time</p></td> <td><p>否</p></td> <td><p>最近连接时间</p></td> </tr> <tr> <td><p>last_connection_error_code</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>最近连接错误码</p></td> </tr> <tr> <td><p>modified_at</p></td> <td><p>string · date-time</p></td> <td><p>是</p></td> <td><p>更新时间</p></td> </tr> <tr> <td><p>name</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>来源名称</p></td> </tr> <tr> <td><p>next_run_at</p></td> <td><p>string · date-time</p></td> <td><p>否</p></td> <td><p>下次同步时间</p></td> </tr> <tr> <td><p>schedule</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>同步频率</p></td> </tr> <tr> <td><p>schedule_anchor_at</p></td> <td><p>string · date-time</p></td> <td><p>否</p></td> <td><p>同步时间（北京时间）</p></td> </tr> <tr> <td><p>settings</p></td> <td><p>object</p></td> <td><p>是</p></td> <td><p>数据源配置</p></td> </tr> <tr> <td><p>source_type</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>数据源类型</p></td> </tr> <tr> <td><p>status</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>状态</p></td> </tr> <tr> <td><p>updated_by_email</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>更新人邮箱</p></td> </tr> <tr> <td><p>updated_by_name</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>更新人</p></td> </tr> </tbody> </table>

#### sources\[\].settings

<table> <thead> <tr> <td><p><b>字段</b></p></td> <td><p><b>类型</b></p></td> <td><p><b>必填</b></p></td> <td><p><b>说明</b></p></td> </tr> </thead> <tbody> <tr> <td><p>connection</p></td> <td><p>object</p></td> <td><p>是</p></td> <td><p>连接配置</p></td> </tr> <tr> <td><p>department_mapping</p></td> <td><p>object</p></td> <td><p>是</p></td> <td><p>部门映射</p></td> </tr> <tr> <td><p>mapping</p></td> <td><p>object</p></td> <td><p>是</p></td> <td><p>成员映射</p></td> </tr> <tr> <td><p>scope</p></td> <td><p>object</p></td> <td><p>是</p></td> <td><p>同步范围</p></td> </tr> <tr> <td><p>wecom</p></td> <td><p>object</p></td> <td><p>否</p></td> <td><p>企业微信部署与地址配置</p></td> </tr> </tbody> </table>

#### sources\[\].settings.connection

<table> <thead> <tr> <td><p><b>字段</b></p></td> <td><p><b>类型</b></p></td> <td><p><b>必填</b></p></td> <td><p><b>说明</b></p></td> </tr> </thead> <tbody> <tr> <td><p>client_name</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>SCIM Client maxLength=255</p></td> </tr> <tr> <td><p>tls_enabled</p></td> <td><p>boolean</p></td> <td><p>否</p></td> <td><p>启用 TLS</p></td> </tr> <tr> <td><p>url</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>服务器地址 maxLength=2048</p></td> </tr> </tbody> </table>

#### sources\[\].settings.department_mapping

<table> <thead> <tr> <td><p><b>字段</b></p></td> <td><p><b>类型</b></p></td> <td><p><b>必填</b></p></td> <td><p><b>说明</b></p></td> </tr> </thead> <tbody> <tr> <td><p>external_id</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>第三方部门 ID（来源字段） maxLength=128</p></td> </tr> <tr> <td><p>name</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>部门名称（来源字段） maxLength=128</p></td> </tr> <tr> <td><p>order</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>排序（来源字段） maxLength=128</p></td> </tr> <tr> <td><p>parent_external_id</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>上级第三方部门 ID（来源字段） maxLength=128</p></td> </tr> <tr> <td><p>status</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>状态（来源字段） maxLength=128</p></td> </tr> </tbody> </table>

#### sources\[\].settings.mapping

<table> <thead> <tr> <td><p><b>字段</b></p></td> <td><p><b>类型</b></p></td> <td><p><b>必填</b></p></td> <td><p><b>说明</b></p></td> </tr> </thead> <tbody> <tr> <td><p>account</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>账号（来源字段） maxLength=128</p></td> </tr> <tr> <td><p>department_external_id</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>所属部门的第三方部门 ID（来源字段） maxLength=128</p></td> </tr> <tr> <td><p>email</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>邮箱（来源字段） maxLength=128</p></td> </tr> <tr> <td><p>employee_no</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>工号（来源字段） maxLength=128</p></td> </tr> <tr> <td><p>external_id</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>第三方用户 ID（来源字段） maxLength=128</p></td> </tr> <tr> <td><p>name</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>用户姓名（来源字段） maxLength=128</p></td> </tr> <tr> <td><p>phone</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>手机号（来源字段） maxLength=128</p></td> </tr> <tr> <td><p>status</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>状态（来源字段） maxLength=128</p></td> </tr> </tbody> </table>

#### sources\[\].settings.scope

<table> <thead> <tr> <td><p><b>字段</b></p></td> <td><p><b>类型</b></p></td> <td><p><b>必填</b></p></td> <td><p><b>说明</b></p></td> </tr> </thead> <tbody> <tr> <td><p>base_dn</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>Base DN maxLength=2048</p></td> </tr> <tr> <td><p>mode</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>同步范围类型；可选值：all, departments, base_dn, administrative_units 取值："administrative_units"、"all"、"base_dn"、"departments"</p></td> </tr> <tr> <td><p>org_unit_external_ids</p></td> <td><p>array\&lt;string\&gt; \| null</p></td> <td><p>否</p></td> <td><p>范围部门（第三方部门 ID 列表） maxItems=200</p></td> </tr> <tr> <td><p>org_unit_filter</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>部门过滤器 maxLength=2048</p></td> </tr> <tr> <td><p>user_filter</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>用户过滤器 maxLength=2048</p></td> </tr> </tbody> </table>

#### sources\[\].settings.wecom

<table> <thead> <tr> <td><p><b>字段</b></p></td> <td><p><b>类型</b></p></td> <td><p><b>必填</b></p></td> <td><p><b>说明</b></p></td> </tr> </thead> <tbody> <tr> <td><p>api_base_url</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>企业微信 API 基础地址 maxLength=2048</p></td> </tr> <tr> <td><p>authorization_url</p></td> <td><p>string</p></td> <td><p>否</p></td> <td><p>企业微信授权地址 maxLength=2048</p></td> </tr> <tr> <td><p>deployment</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>企业微信部署类型；可选值：standard, private 取值："private"、"standard"</p></td> </tr> </tbody> </table>

## 响应示例
```
HELPCODEESCAPE-json
{
  "sources": [
    {
      "config_revision": 0,
      "connection_status": "<string>",
      "created_at": "2026-08-27T10:00:00Z",
      "created_by_email": "<string>",
      "created_by_name": "<string>",
      "credential_configured": false,
      "default_seat": false,
      "deletion_alert_email": "<string>",
      "deletion_alert_enabled": false,
      "deletion_alert_threshold": 0,
      "deletion_policy": "<string>",
      "external_id_field": "<string>",
      "external_id_field_locked": false,
      "id": "<uuid>",
      "last_activity_at": "2026-08-27T10:00:00Z",
      "last_connected_at": "2026-08-27T10:00:00Z",
      "last_connection_error_code": "<string>",
      "modified_at": "2026-08-27T10:00:00Z",
      "name": "<string>",
      "next_run_at": "2026-08-27T10:00:00Z",
      "schedule": "<string>",
      "schedule_anchor_at": "2026-08-27T10:00:00Z",
      "settings": {
        "connection": {
          "client_name": "<string>",
          "tls_enabled": false,
          "url": "<string>"
        },
        "department_mapping": {
          "external_id": "<string>",
          "name": "<string>",
          "order": "<string>",
          "parent_external_id": "<string>",
          "status": "<string>"
        },
        "mapping": {
          "account": "<string>",
          "department_external_id": "<string>",
          "email": "<string>",
          "employee_no": "<string>",
          "external_id": "<string>",
          "name": "<string>",
          "phone": "<string>",
          "status": "<string>"
        },
        "scope": {
          "base_dn": "<string>",
          "mode": "all",
          "org_unit_external_ids": [
            "<string>"
          ],
          "org_unit_filter": "<string>",
          "user_filter": "<string>"
        }
      },
      "source_type": "<string>",
      "status": "<string>",
      "updated_by_email": "<string>",
      "updated_by_name": "<string>"
    }
  ]
}
```

## 企业微信私有化配置
企业微信保持 `source_type: "wecom"`。`settings.wecom` 为可选对象：`deployment` 为 `standard` 或 `private`， `api_base_url` 为私有化企微的 HTTPS API 基础地址；`authorization_url` 为可选授权地址。 未配置时使用标准版固定地址；更新省略 `settings.wecom` 时保留原配置。 私有化服务须兼容企微协议且能由服务端直接访问，禁止明文 HTTP、跳过证书校验或失败时回退公网地址。 连接测试、部门读取和同步复用该地址；原属性映射、Scope 和同步策略不变。 消息回调凭据在管理控制台单独配置，不通过本接口读取或写入。