开发者

私网端点接入

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

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

创建接口终端节点

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

进入阿里云专有网络控制台 → 终端节点，点击「创建终端节点」。在「终端节点服务名称」字段中，填入以下全账号通用、固定不变的服务名：

code

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

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

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

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

跨地域配置： 当 VPC 不在北京地域时使用；跨地域流量由云数据传输 CDT 结算，按量计费。

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

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

获取终端节点域名

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

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

code

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

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

替换 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 计费详情；同地域无此费用。
公网仍可用：私网端点上线后公网 Base URL 不会被停用，可按需混用。

关键参数速查

点金 OpenAPI 服务名（固定）

code

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

终端节点域名模板

code

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

Base URL 替换前后

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