獲取UA

1. 接口描述

https://dev.kdlapi.com/api/getua 英文代號：get ua

獲取爬蟲程序發(fā)起請求所需的User-Agent頭信息(UA)。

支持訂單或賬戶API密鑰調(diào)用本接口
接口最快調(diào)用頻率：
1. 付費用戶 1秒5次
2. 免費用戶 1秒1次

2. 參數(shù)說明

參數(shù)	是否必填	參數(shù)說明	取值說明
secret_id	是	訂單或賬戶SecretId	查看API密鑰信息
sign_type	否	簽名驗證方式。目前支持token和hmacsha1。	默認(rèn)值：token
signature	是	請求簽名，用來驗證此次請求的合法性。	支持2種簽名驗證方式，簽名計算方法參見API 授權(quán)與驗證
timestamp	否	當(dāng)前 UNIX 時間戳（秒級），可記錄發(fā)起 API 請求的時間。 sign_type=hmacsha1時此參數(shù)有效且為必填項。	例如1557546010，如果與當(dāng)前時間相差過大，會引起簽名過期錯誤。
nonce	否	隨機正整數(shù)，與 timestamp 聯(lián)合起來，用于防止重放攻擊。建議攜帶此參數(shù)進一步提升API安全性。 sign_type=hmacsha1時此參數(shù)有效。	客戶自行生成隨機正整數(shù)，如random.randint(1, 100000000)
num	是	提取數(shù)量	單次最大提取數(shù)量：累計消費>1萬元：300個累計消費>5000元：100個累計消費>1元：30個暫無消費：3個
dt	否	設(shè)備類型	all: 所有設(shè)備UA(默認(rèn)) pc: 電腦設(shè)備UA mobile: 手機設(shè)備UA pad: 平板設(shè)備UA 多種設(shè)備用英文逗號分隔，如 mobile,pad
platform	否	平臺類型	all: 所有平臺UA(默認(rèn)) win: windows系統(tǒng)UA macos: mac系統(tǒng)UA linux: 電腦linux系統(tǒng)UA ios: iOS系統(tǒng)UA android: 安卓系統(tǒng)UA 多個平臺用英文逗號分隔，如 ios,android
browser	否	瀏覽器類型	all: 所有瀏覽器UA(默認(rèn)) chrome: 谷歌瀏覽器UA firefox: 火狐瀏覽器UA ie: IE瀏覽器UA weixin: 微信內(nèi)置瀏覽器UA 多種瀏覽器用英文逗號分隔，如 chrome,firefox

3. 調(diào)用示例

在會員中心API密鑰管理頁得到訂單的SecretId和SecretKey：

SecretId：o1fjh1re9o28876h7c08
SecretKey：jd1gzm6ant2u7pojhbtl0bam0xpzsm1c

以密鑰令牌驗證為例，調(diào)用獲取密鑰令牌接口得到密鑰令牌：

SecretToken：oxf0n0g59h7wcdyvz2uo68ph2s

調(diào)用示例

獲取兩個隨機ua

GET https://dev.kdlapi.com/api/getua?secret_id=o1fjh1re9o28876h7c08
&num=2
&signature=oxf0n0g59h7wcdyvz2uo68ph2s

使用說明

點擊查看關(guān)于API授權(quán)與驗證的介紹

4. 返回結(jié)果

接口返回json格式，樣例：

{
  "msg": "",
  "code": 0,
  "data": {
    "count": 2,
    "ua_list": [
      "Mozilla/5.0 (iPhone 92; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Version/10.0 MQQBrowser/7.2.1 Mobile/14G60 Safari/8536.25 MttCustomUA/2 QBWebViewType/1",
      "Mozilla/5.0 (Linux; Android 6.0; HUAWEI CRR-UL00 Build/HUAWEICRR-UL00; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/53.0.2785.49 Mobile MQQBrowser/6.2 TBS/043622 Safari/537.36 V1_AND_SQ_7.1.8_718_YYB_D QQ/7.1.8.3240 NetType/4G WebP/0.3.0 Pixel/1080",
    ]
  }
}

異常返回格式樣例：

{"code": -1, "msg": "參數(shù)錯誤", "data": ""}

5. 錯誤碼一覽

錯誤碼	說明
-1	缺少參數(shù)
-2	提取數(shù)量填寫錯誤
-6	提取數(shù)量超限

6. SDK

快代理提供了配套的開發(fā)工具集（SDK），支持多種編程語言，能更方便的調(diào)用 API。

SDK下載