创建连接器

将 <BASE_URL> 替换为所在企业环境的 API 域名。

• Scope：admin.v1.connectors.manage
• 权限项：连接器管理（connectors）
• 权限类型：管理
• 接口：POST/api/openapi/v1/connectors

认证与请求头

使用应用 API Key 调用。当前接口只校验上方独立 Scope；读取、管理与执行权限互不隐含。

请求参数

请求示例

cURL

curl --request POST \
  --url '<BASE_URL>/api/openapi/v1/connectors' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Idempotency-Key: <UNIQUE_REQUEST_ID>' \
  --header 'Content-Type: application/json' \
  --data '{
  "api_key": {
    "header_name": "<string>",
    "value_prefix": "<string>"
  },
  "auth_type": "none",
  "category_id": "<uuid>",
  "clients": [
    "<string>"
  ],
  "command": "<string>",
  "description": "<string>",
  "description_cn": "<string>",
  "display_name": "<string>",
  "display_name_cn": "<string>",
  "icon_upload_id": "<uuid>",
  "icon_url": "<string>",
  "oauth_client_registration": "dcr",
  "oauth_scopes": "<string>",
  "server_key": "<string>",
  "transport": "http",
  "url": "<string>"
}'

响应

201 Created

响应示例

{
  "api_key": {
    "header_name": "<string>",
    "value_prefix": "<string>"
  },
  "auth_type": "<string>",
  "clients": [
    "<string>"
  ],
  "command": "<string>",
  "created_at": "2026-08-27T10:00:00Z",
  "description": "<string>",
  "description_cn": "<string>",
  "display_name": "<string>",
  "display_name_cn": "<string>",
  "icon_url": "<string>",
  "id": "<string>",
  "oauth_client_registration": "<string>",
  "oauth_scopes": "<string>",
  "origin": "<string>",
  "revision": 0,
  "server_key": "<string>",
  "source_type": "official",
  "status": "<string>",
  "transport": "<string>",
  "updated_at": "2026-08-27T10:00:00Z",
  "url": "<string>",
  "version": "<string>"
}

default Flat business error

响应示例

{
  "code": "<string>",
  "detail": "<string>",
  "details": {
    "field": "<string>",
    "reason": "<string>",
    "suggestion": "<string>"
  },
  "error": "<string>"
}