You need to enable JavaScript to run this app.
TrafficRoute DNS 套件

TrafficRoute DNS 套件

请输入
  • 文档首页
    • TrafficRoute DNS 套件移动解析 HTTPDNS客户端开发指南使用 HTTP API获取最佳的 HTTPDNS 服务端 IP 地址
复制全文
我的收藏
使用 HTTP API
获取最佳的 HTTPDNS 服务端 IP 地址
复制全文
我的收藏
获取最佳的 HTTPDNS 服务端 IP 地址

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
}
最近更新时间：2023.09.22 15:26:42
这个页面对您有帮助吗？
有用
有用
无用
无用