查询隧道代理当前IP

https://tps.kdlapi.com/api/tpscurrentip 英文代号：tps current ip

实时查询隧道代理当前IP。
隧道代理会根据您购买时选择的周期自动切换IP，使用途中您可以随时调用此接口查询隧道的当前IP。

温馨提示：此接口不是提取代理IP的接口

隧道代理的特点是设置一次代理，之后会定期在云端自动切换IP，因此主流的使用方式您无需通过API提取IP，也无需处理换IP的逻辑。
此接口是用于实时查询隧道代理的当前IP。

如果您的使用场景需要先提取代理IP，请使用获取隧道代理IP接口

参数	是否必填	参数说明	取值说明
orderid	是	订单号	有效的订单号。查看我的订单
sign_type	否	签名验证方式。目前支持simple和hmacsha1。	默认值：simple
signature	是	请求签名，用来验证此次请求的合法性。	支持2种签名验证方式，签名计算方法参见API 授权与验证
timestamp	否	当前 UNIX 时间戳（秒级），可记录发起 API 请求的时间。 sign_type=hmacsha1时此参数为必填项。	例如1557546010，如果与当前时间相差过大，会引起签名过期错误。

在会员中心订单API接口页面得到订单号和API Key。

为演示简单，这里采用密钥明文验证生成签名参数，建议您在生产环境采用数字签名验证。

调用示例

GET https://tps.kdlapi.com/api/gettpsip?orderid=965102959536478
&signature=jd1gzm6ant2u7pojhbtl0bam0xpzsm1c

接口返回json格式，样例：

{
  "msg": "",
  "code": 0,
  "data": {
    "current_ip": "123.35.67.46"
  }
}

字段说明如下：

data.current_ip为空串的情况

data.current_ip可能为空串，有如下两种情况：

隧道当前并未被使用，所以没有分配IP（隧道只有在使用时才会实时分配IP）；
分配的IP已过期。
比如您购买的1分钟换IP的隧道，但请求隧道的频率却是每2分钟请求一次，调用tpscurrentip接口时距离前一次请求隧道已过去1分半钟，前一次请求分配的IP已失效，因后一次请求尚未到来，隧道并没有分配IP，所以返回了空串。

错误码	说明
-3	订单类型错误，只支持隧道代理订单
-4	隧道订单不支持此接口（换IP周期>=1分钟的隧道才支持）

快代理提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

免费代理