# 获取服务详情

`GET` `/api/agent/finx/getServiceDetail`

获取单个 Finx 服务的完整详情，包括基本信息（id、name、displayName、type、enabled、toolCount等）、类型化配置（MCP服务的serverUrl/transportType/requestTimeoutSeconds，HTTP服务的baseUrl及 serviceEndpoint，serviceEndpoint 含 method/path/contentType/timeout/queryParams/streaming/resultEventName）以及授权状态（authType、是否已配置凭证、凭证字段列表含脱敏值、凭证来源等）。其中 streaming 标识服务端点是否以SSE方式连接客户端（默认false），resultEventName 为SSE流中作为模型观察结果的保留事件名（默认 tool_observation）。注意：授权状态里的字段名为 authType，而创建/编辑服务时请求体里的键名是 auth.type，回传时不要混用。凭证值均为脱敏返回，不会暴露明文；编辑服务时将脱敏值原样回传即表示保留原值。

## 请求参数

### 请求头参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| X-Principal-Id | integer | 否 | 身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。 |

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| agentId | integer | 是 | 智能体ID，必填 |
| serviceName | string | 是 | 服务名称，必填 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | FinxServiceDetail | 响应数据 |
|     id | integer | - |
|     name | string | - |
|     displayName | string | - |
|     logoUrl | string | - |
|     description | string | - |
|     type | string | - |
|     enabled | boolean | - |
|     toolCount | integer | - |
|     createdAt | string | - |
|     updatedAt | string | - |
|     parameterSchema | string | - |
|     mcpConfig | McpConfigInfo | - |
|         serverUrl | string | - |
|         transportType | string | - |
|         requestTimeoutSeconds | integer | - |
|         testVariables | object | - |
|         requiredTestVariables | array | - |
|     httpConfig | HttpConfigInfo | - |
|         baseUrl | string | - |
|         serviceEndpoint | FinxHttpEndpointInfo | - |
|             method | string | - |
|             path | string | - |
|             contentType | string | - |
|             timeout | integer | - |
|             queryParams | array | - |
|             streaming | boolean | - |
|             resultEventName | string | - |
|     auth | FinxAuthInfo | - |
|         authRequired | boolean | - |
|         hasAuth | boolean | - |
|         complete | boolean | - |
|         authType | string | - |
|         authTypeDescription | string | - |
|         requireUserProvided | boolean | - |
|         credentialSource | string | - |
|         headerName | string | - |
|         tokenPrefix | string | - |
|         fields | array | - |
|             key | string | - |
|             displayName | string | - |
|             configured | boolean | - |
|             maskedValue | string | - |
|         tokenFetchConfig | TokenFetchConfigInfo | - |
|             url | string | - |
|             method | string | - |
|             headers | object | - |
|             bodyConfigured | boolean | - |
|             tokenField | string | - |
|             expiresInField | string | - |
|             targetHeaderName | string | - |
|             targetTokenPrefix | string | - |
|     system | boolean | - |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |