You need to enable JavaScript to run this app.
导航
获取最佳的 HTTPDNS 服务端 IP 地址
最近更新时间:2023.09.22 15:26:42首次发布时间:2023.07.21 15:05:35

API 说明

获取最佳的 HTTPDNS 服务端 IP 地址。您可以使用 HTTP 请求或 HTTPS 请求。该 API 的请求不计费。

说明

该 API 处于公测阶段,目前默认关闭。如果您希望体验该功能,可以 提交工单 联系我们开启该 API。

说明

客户端 SDK 可以自动获取最佳的 HTTPDNS 服务端 IP 地址。如果您无法使用客户端 SDK,您可以使用该 API 获取最佳的 HTTPDNS 服务端地址。

您可以使用 httpdns.volcengineapi.com 作为请求域名,也可以向 HTTPDNS 服务端的固定 IP 地址发送直连请求。

使用 httpdns.volcengineapi.com 作为请求域名

GET https://httpdns.volcengineapi.com/svc_meta?account_id={account_id}&sign={sign}&svc_meta_ts={svc_meta_ts}&timestamp={timestamp}
GET http://httpdns.volcengineapi.com/svc_meta?account_id={account_id}&sign={sign}&svc_meta_ts={svc_meta_ts}&timestamp={timestamp}

向 HTTPDNS 服务端的固定 IP 地址发送直连请求

GET https://{ip_address}/svc_meta?account_id={account_id}&sign={sign}&svc_meta_ts={svc_meta_ts}&timestamp={timestamp}
GET http://{ip_address}/svc_meta?account_id={account_id}&sign={sign}&svc_meta_ts={svc_meta_ts}&timestamp={timestamp}

说明

固定 IP 地址接入功能处于公测阶段,暂不对外公开。您可以 提交工单 联系我们获取固定 IP 地址

查询参数

参数名称数据类型是否必选参数说明
account_idString您的 Service ID。可以从控制台的 鉴权配置 页面获取。
svc_meta_tsString上一次请求返回的 ts 参数的值。HTTPDNS 服务端可以根据该参数监控客户端更新 HTTPDNS 服务端 IP 地址的比例。您也可以把该参数设为 0。
signString指定请求的签名,用来对请求进行鉴权。签名计算方法见 计算签名

timestamp

String

指定签名的过期时间。时间的格式为 Unix 时间戳,单位是毫秒。例如,1653021179804 表示签名在 2022 年 5 月 20 日 04:32:59(UTC 时间) 过期。

如果 HTTPDNS 服务端收到了过期的签名,该请求会被丢弃。这样可以防止重放攻击。

警告

  • 该参数 不能 是当前时间。否则,请求到达 HTTPDNS 服务端时,签名已过期。
  • 该参数的单位必须是 毫秒

响应正文

参数名称数据类型参数说明
svc_metaObject可用的 HTTPDNS 服务端 IP 地址信息。参见 svc_meta 对象
tsInteger本次获得 HTTPDNS 服务端地址的 Unix 时间戳,单位是毫秒。例如,1653021179804 表示本次获得 HTTPDNS 服务端地址的时间是 2022 年 5 月 20 日 04:32:59(UTC 时间)。

您可以自行保存该参数的值,用于定时向 HTTPDNS 服务端发送请求,获取最新的 IP 地址。
update_interval_minInteger获取最新的 HTTPDNS 服务端 IP 地址的建议时间间隔(分钟)。

svc_meta 对象

参数名称数据类型参数说明
main_domainsString Array推荐您优先使用的 HTTPDNS 服务端 IP 地址。您可以按照列表中 IP 地址的顺序,按照轮询逻辑依次尝试访问。
backup_domainsString ArrayHTTPDNS 服务端备用 IP 地址。如果 main_domains 中的 IP 地址都不可用,那么您可以尝试访问该地址。

请求示例

https://httpdns.volcengineapi.com/svc_meta?account_id=2100212964&svc_meta_ts=1677139810853&timestamp=1677139810853&sign=bf0525e89431b5820af17555ba4c13a1 

响应示例

{
  "svc_meta": {
    "main_domains": [
      "1.1.1.1",
      "2.2.2.2",
      "3.3.3.3"
    ],
    "backup_domains": [
      "4.4.4.4"
    ]
  },
  "ts": 1676777261000,
  "update_interval_min": 30
}