更換隧道代理IP
1. 接口描述
https://tps.kdlapi.com/api/changetpsip 英文代號(hào):change tps ip
更換隧道代理IP。
隧道代理會(huì)根據(jù)您購買時(shí)選擇的周期自動(dòng)切換IP,但使用途中如果您發(fā)現(xiàn)該IP不可用,可以調(diào)用此接口讓隧道立即更換一個(gè)新IP。
多通道隧道可通過此接口更換部分或全部通道的IP。
- 必須使用訂單API密鑰調(diào)用本接口
- 支持換IP周期>=1分鐘的隧道代理訂單
- 接口最快調(diào)用頻率: 1秒1次
此接口的頻率限制
在隧道的1個(gè)換IP周期內(nèi),調(diào)用此接口更換IP的次數(shù)不能超過2次。
舉例說明:您購買的是5分鐘換IP的隧道,那么5分鐘內(nèi)您最多可以調(diào)用此接口2次。
2. 參數(shù)說明
| 參數(shù) | 是否必填 | 參數(shù)說明 | 取值說明 |
|---|---|---|---|
| secret_id | 是 | 訂單SecretId | 查看訂單API密鑰信息 |
| sign_type | 否 | 簽名驗(yàn)證方式。目前支持token和hmacsha1。 | 默認(rèn)值:token |
| signature | 是 | 請(qǐng)求簽名,用來驗(yàn)證此次請(qǐng)求的合法性。 | 支持2種簽名驗(yàn)證方式,簽名計(jì)算方法參見API 授權(quán)與驗(yàn)證 |
| timestamp | 否 | 當(dāng)前 UNIX 時(shí)間戳(秒級(jí)),可記錄發(fā)起 API 請(qǐng)求的時(shí)間。 sign_type=hmacsha1時(shí)此參數(shù)有效且為必填項(xiàng)。 |
例如1557546010,如果與當(dāng)前時(shí)間相差過大,會(huì)引起簽名過期錯(cuò)誤。 |
| nonce | 否 | 隨機(jī)正整數(shù),與 timestamp 聯(lián)合起來,用于防止重放攻擊。建議攜帶此參數(shù)進(jìn)一步提升API安全性。 sign_type=hmacsha1時(shí)此參數(shù)有效。 |
客戶自行生成隨機(jī)正整數(shù),如random.randint(1, 100000000) |
| changeip | 否 | 需要更換的IP。(多個(gè)IP用英文逗號(hào)分隔) 此參數(shù)只對(duì)多通道隧道生效。 |
此參數(shù)包含的通道IP均會(huì)通過本次調(diào)用更換。 不帶此參數(shù)或參數(shù)值為空串代表更換所有通道IP。 |
3. 調(diào)用示例
在會(huì)員中心API密鑰管理頁得到訂單的SecretId和SecretKey:
- SecretId:
o1fjh1re9o28876h7c08 - SecretKey:
jd1gzm6ant2u7pojhbtl0bam0xpzsm1c
以密鑰令牌驗(yàn)證為例,調(diào)用獲取密鑰令牌接口得到密鑰令牌:
- SecretToken:
oxf0n0g59h7wcdyvz2uo68ph2s
調(diào)用示例
GET https://tps.kdlapi.com/api/changetpsip?secret_id=o1fjh1re9o28876h7c08
&signature=oxf0n0g59h7wcdyvz2uo68ph2s
使用說明
點(diǎn)擊查看關(guān)于API授權(quán)與驗(yàn)證的介紹
4. 返回結(jié)果
接口返回json格式,樣例:
{
"msg": "",
"code": 0,
"data": {
"new_ip": "123.35.67.46",
"new_ip_list": ["123.35.67.46", "125.100.86.128"]
}
}
字段說明如下:
| 參數(shù) | 說明 |
|---|---|
| code | 返回碼。取值:0代表成功 非0代表失敗 |
| msg | 錯(cuò)誤信息 |
| data.new_ip | 新更換的IP。 對(duì)多通道隧道此字段為第一個(gè)通道更換后的新IP。 |
| data.new_ip_list | 新更換的IP列表。 對(duì)多通道隧道此字段包含每個(gè)通道更換后的新IP。 |
5. 錯(cuò)誤碼一覽
| 錯(cuò)誤碼 | 說明 |
|---|---|
| -3 | 訂單類型錯(cuò)誤,只支持隧道代理訂單 |
| -4 | 隧道訂單不支持此接口(換IP周期>=1分鐘的隧道才支持) |
| -5 | 換IP次數(shù)超限 |
6. SDK
快代理提供了配套的開發(fā)工具集(SDK),支持多種編程語言,能更方便的調(diào)用 API。