# get_endpoint_detail

获取端点的完整详细信息，包括参数、请求体和响应格式。

## 参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `endpointId` | string | 是 | 端点 ID，可从 `list_endpoints` 或 `search_endpoints` 获取 |

## 返回结果

```json
{
  "id": "ep_001",
  "method": "POST",
  "path": "/v1/charges",
  "summary": "Create a charge",
  "description": "Creates a new charge object. If the charge fails, the API returns an error.",
  "operationId": "createCharge",
  "moduleName": "Payments",
  "parameters": [
    {
      "name": "Idempotency-Key",
      "in": "header",
      "required": false,
      "schema": { "type": "string" },
      "description": "Unique key for idempotent requests"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": ["amount", "currency"],
          "properties": {
            "amount": { "type": "integer", "description": "Amount in cents" },
            "currency": { "type": "string", "description": "Three-letter ISO currency code" },
            "source": { "type": "string", "description": "Payment source token" }
          }
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Charge created successfully",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "id": { "type": "string" },
              "amount": { "type": "integer" },
              "status": { "type": "string" }
            }
          }
        }
      }
    }
  },
  "deprecated": false
}
```

## 返回字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | string | 端点 ID |
| `method` | string | HTTP 方法 |
| `path` | string | API 路径 |
| `summary` | string | 端点摘要 |
| `description` | string | 端点详细描述 |
| `operationId` | string | 操作标识符 |
| `moduleName` | string | 所属模块名称 |
| `parameters` | array | URL/查询/头部/Cookie 参数列表（原始 OpenAPI schema） |
| `requestBody` | object | 请求体规范 |
| `responses` | object | HTTP 响应规范（按状态码分组） |
| `deprecated` | boolean | 是否已弃用 |

## Token 消耗

约 **500-2,000 tokens**，取决于参数数量和响应 schema 的复杂程度。这是 token 消耗最多的工具，但也是信息最丰富的。

## 使用场景

- 需要了解如何调用某个具体端点
- 查看请求参数的类型、是否必填、描述
- 查看响应格式以便解析返回数据