查询目录数据源配置接口
将 <BASE_URL> 替换为所在企业环境的 API 域名。
- Scope:
admin.v1.directory-sync-config.read - 权限项:用户同步配置读取(
directory-sync-config) - 权限类型:读取
- 接口:GET
/api/openapi/v1/directory-sync/sources
认证与请求头
使用应用 API Key 调用。当前接口只校验上方独立 Scope;读取、管理与执行权限互不隐含。
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | 应用 API Key,使用 Bearer 方式传递。 | Bearer qwk_*** |
X-Request-Id | header | string | 否 | 可选的调用追踪标识;未传入时由服务端生成。 | req-20260831-001 |
请求参数
此接口没有额外请求参数。
请求示例
cURL
curl --request GET \
--url '<BASE_URL>/api/openapi/v1/directory-sync/sources' \
--header 'Authorization: Bearer <API_KEY>'响应
200 OK
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
sources | array<OpenapifacadeDirectorySource> | 是 | - | [{"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>"}] |
sources[].config_revision | integer · int64 | 是 | - | 0 |
sources[].connection_status | string | 是 | - | "<string>" |
sources[].created_at | string · date-time | 是 | - | "2026-08-27T10:00:00Z" |
sources[].created_by_email | string | 否 | - | "<string>" |
sources[].created_by_name | string | 否 | - | "<string>" |
sources[].credential_configured | boolean | 是 | - | false |
sources[].default_seat | boolean | 是 | - | false |
sources[].deletion_alert_email | string | 否 | - | "<string>" |
sources[].deletion_alert_enabled | boolean | 是 | - | false |
sources[].deletion_alert_threshold | integer · int64 | 是 | - | 0 |
sources[].deletion_policy | string | 是 | - | "<string>" |
sources[].external_id_field | string | 是 | - | "<string>" |
sources[].external_id_field_locked | boolean | 是 | - | false |
sources[].id | string · uuid | 是 | - | "<uuid>" |
sources[].last_activity_at | string · date-time | 否 | - | "2026-08-27T10:00:00Z" |
sources[].last_connected_at | string · date-time | 否 | - | "2026-08-27T10:00:00Z" |
sources[].last_connection_error_code | string | 否 | - | "<string>" |
sources[].modified_at | string · date-time | 是 | - | "2026-08-27T10:00:00Z" |
sources[].name | string | 是 | - | "<string>" |
sources[].next_run_at | string · date-time | 否 | - | "2026-08-27T10:00:00Z" |
sources[].schedule | string | 是 | - | "<string>" |
sources[].schedule_anchor_at | string · date-time | 否 | - | "2026-08-27T10:00:00Z" |
sources[].settings | OpenapifacadeDirectorySourceSettings | 是 | - | {"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>"}} |
sources[].settings.connection | OpenapifacadeDirectorySourceConnection | 是 | - | {"client_name":"<string>","tls_enabled":false,"url":"<string>"} |
sources[].settings.connection.client_name | string | 否 | - | "<string>" |
sources[].settings.connection.tls_enabled | boolean | 否 | - | false |
sources[].settings.connection.url | string | 否 | - | "<string>" |
sources[].settings.department_mapping | OpenapifacadeDirectorySourceDepartmentMapping | 是 | - | {"external_id":"<string>","name":"<string>","order":"<string>","parent_external_id":"<string>","status":"<string>"} |
sources[].settings.department_mapping.external_id | string | 是 | - | "<string>" |
sources[].settings.department_mapping.name | string | 是 | - | "<string>" |
sources[].settings.department_mapping.order | string | 否 | - | "<string>" |
sources[].settings.department_mapping.parent_external_id | string | 否 | - | "<string>" |
sources[].settings.department_mapping.status | string | 否 | - | "<string>" |
sources[].settings.mapping | OpenapifacadeDirectorySourceFieldMapping | 是 | - | {"account":"<string>","department_external_id":"<string>","email":"<string>","employee_no":"<string>","external_id":"<string>","name":"<string>","phone":"<string>","status":"<string>"} |
sources[].settings.mapping.account | string | 否 | - | "<string>" |
sources[].settings.mapping.department_external_id | string | 否 | - | "<string>" |
sources[].settings.mapping.email | string | 否 | - | "<string>" |
sources[].settings.mapping.employee_no | string | 否 | - | "<string>" |
sources[].settings.mapping.external_id | string | 是 | - | "<string>" |
sources[].settings.mapping.name | string | 是 | - | "<string>" |
sources[].settings.mapping.phone | string | 否 | - | "<string>" |
sources[].settings.mapping.status | string | 否 | - | "<string>" |
sources[].settings.scope | OpenapifacadeDirectorySourceScope | 是 | - | {"base_dn":"<string>","mode":"all","org_unit_external_ids":["<string>"],"org_unit_filter":"<string>","user_filter":"<string>"} |
sources[].settings.scope.base_dn | string | 否 | - | "<string>" |
sources[].settings.scope.mode | string | 是 | - | "all" |
sources[].settings.scope.org_unit_external_ids | array | null | 否 | - | ["<string>"] |
sources[].settings.scope.org_unit_filter | string | 否 | - | "<string>" |
sources[].settings.scope.user_filter | string | 否 | - | "<string>" |
sources[].source_type | string | 是 | - | "<string>" |
sources[].status | string | 是 | - | "<string>" |
sources[].updated_by_email | string | 否 | - | "<string>" |
sources[].updated_by_name | string | 否 | - | "<string>" |
响应示例
{
"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": [
null
],
"org_unit_filter": "<string>",
"user_filter": "<string>"
}
},
"source_type": "<string>",
"status": "<string>",
"updated_by_email": "<string>",
"updated_by_name": "<string>"
}
]
}default Flat business error
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
code | string | 否 | Stable business error code | "<string>" |
detail | string | 是 | Human-readable error description | "<string>" |
details | OpenapiErrorDetails | 否 | - | {"field":"<string>","reason":"<string>","suggestion":"<string>"} |
details.field | string | 否 | Request field that failed validation | "<string>" |
details.reason | string | 否 | Stable validation failure reason | "<string>" |
details.suggestion | string | 否 | Suggested normalized value | "<string>" |
error | string | 是 | Stable HTTP error type | "<string>" |
响应示例
{
"code": "<string>",
"detail": "<string>",
"details": {
"field": "<string>",
"reason": "<string>",
"suggestion": "<string>"
},
"error": "<string>"
}