# 通过私网地址访问点金

通过私网地址访问点金OpenAPI，无需公网出口，保留全部 API 路径与鉴权方式，安全可靠。

## 私网端点接入

3 步基于阿里云 PrivateLink 让 VPC 内服务以内网链路调用点金 OpenAPI，无需公网出口、保留全部 API 路径与鉴权方式。

> **前置条件：** 阿里云账号已开通 VPC 与 PrivateLink，目标 VPC 至少包含一个交换机；当前已能通过公网 Base URL `https://router.fis.aliyuncs.com/finx` 成功调用点金 OpenAPI。

### Step 1: 创建接口终端节点

在专有网络控制台创建接口终端节点并关联目标 VPC。

进入[阿里云专有网络控制台 → 终端节点](https://vpc.console.aliyun.com/endpoint/cn-beijing/endpoints)，点击「[创建终端节点](https://vpc.console.aliyun.com/endpoint/cn-beijing/endpoints/new)」。在「终端节点服务名称」字段中，填入以下**全账号通用、固定不变**的服务名：

```
com.aliyuncs.privatelink.cn-beijing.epsrv-2ze7lrpsqbaewls93fty
```

按 VPC 所在地域选择以下两种配置之一，其余字段保持默认。

**同可用区配置（推荐）：** 终端节点与点金服务部署在同一地域，无需承担跨地域流量费用。

| 字段 | 取值 |
| --- | --- |
| 所属地域 | 华北 2（北京） |
| 终端节点类型 | 接口终端节点 |
| 节点名称 | `dianjin-agent-endpoint`（推荐） |
| 类型 | 其他终端节点服务 |
| 服务地域 | **不勾选**「启用跨地域端点」 |
| 网络配置 → 专有网络 | 北京地域下需要打通的 VPC |
| IP 版本 | IPv4 |

**跨地域配置：** 当 VPC 不在北京地域时使用；跨地域流量由[云数据传输 CDT](https://help.aliyun.com/zh/cdt/inter-region-data-transfers) 结算，按量计费。

| 字段 | 取值（以华东 1 杭州为例） |
| --- | --- |
| 所属地域 | 华东 1（杭州） |
| 终端节点类型 | 接口终端节点 |
| 节点名称 | `dianjin-agent-endpoint`（推荐） |
| 类型 | 其他终端节点服务 |
| 服务地域 | **勾选**「启用跨地域端点」并选择「华北 2（北京）」 |
| 跨地域带宽 | 按需配置（最大 1000 Mbps），按 CDT 计费 |
| 网络配置 → 专有网络 | 杭州地域下需要打通的 VPC |
| IP 版本 | IPv4 |

填写完成后点击「确定创建」，等待终端节点状态变为「已连接」。

### Step 2: 获取终端节点域名

复制控制台自动生成的私网域名。

终端节点状态变为「已连接」后，在列表页可以看到自动生成的「终端节点域名」，示例如下：

```
ep-2zeiae8a0597c3a06829.epsrv-2ze7lrpsqbaewls93fty.cn-beijing.privatelink.aliyuncs.com
```

**域名规则：** `<终端节点 ID>.<服务 ID>.<服务地域>.privatelink.aliyuncs.com`。每个账号的终端节点 ID 不同，请使用实际值，**不要照搬示例**。

### Step 3: 替换 Base URL 调用

将公网 Base URL 替换为私网域名，API 路径与鉴权保持不变。

| 类型 | Base URL |
| --- | --- |
| 公网 | `https://router.fis.aliyuncs.com/finx` |
| 私网 | `https://<你的终端节点域名>/finx` |

> 私网域名整体平替 `router.fis.aliyuncs.com`，**`/finx` 前缀仍需保留**，API 路径与鉴权方式与公网完全一致。

```bash
# 私网调用示例
curl -X POST 'https://ep-2zeiae8a0597c3a06829.epsrv-2ze7lrpsqbaewls93fty.cn-beijing.privatelink.aliyuncs.com/finx/api/principal/create' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"principalName":"客服机器人主体"}'
```

> **注意事项**
> 
> - **DNS 解析范围**：终端节点域名仅在已关联的 VPC 内可解析。跨 VPC 访问需先通过 VPC 对等连接或云企业网将网络连通。
> - **HTTPS 证书**：私网域名沿用阿里云 PrivateLink 通配证书，调用方无需特殊处理。
> - **服务名固定**：终端节点服务名称 `com.aliyuncs.privatelink.cn-beijing.epsrv-2ze7lrpsqbaewls93fty` 全账号通用，请勿替换；需要替换的只有自己创建出的「终端节点域名」。
> - **跨地域计费**：勾选「启用跨地域端点」会产生 CDT 流量费用，详见 [CDT 计费详情](https://help.aliyun.com/zh/cdt/inter-region-data-transfers)；同地域无此费用。
> - **公网仍可用**：私网端点上线后公网 Base URL 不会被停用，可按需混用。

### 关键参数速查

**点金 OpenAPI 服务名（固定）**

```
com.aliyuncs.privatelink.cn-beijing.epsrv-2ze7lrpsqbaewls93fty
```

**终端节点域名模板**

```
<endpoint-id>.<service-id>.<region>.privatelink.aliyuncs.com
```

**Base URL 替换前后**

| 类型 | URL |
| --- | --- |
| 公网 | `https://router.fis.aliyuncs.com/finx` |
| 私网 | `https://<endpoint-domain>/finx` |