獲取海外動態代理地區編碼

1. 接口描述

https://dev.kdlapi.com/api/getfpsareacode 英文代號：get fps area code

支持訂單或賬戶API密鑰調用本接口
接口最快調用頻率：1秒1次

2. 參數說明

參數	是否必填	參數說明	取值說明
secret_id	是	訂單或賬戶SecretId	查看API密鑰信息
sign_type	否	簽名驗證方式。目前支持token和hmacsha1。	默認值：token
signature	是	請求簽名，用來驗證此次請求的合法性。	支持2種簽名驗證方式，簽名計算方法參見API 授權與驗證
timestamp	否	當前 UNIX 時間戳（秒級），可記錄發起 API 請求的時間。 sign_type=hmacsha1時此參數有效且為必填項。	例如1557546010，如果與當前時間相差過大，會引起簽名過期錯誤。
nonce	否	隨機正整數，與 timestamp 聯合起來，用于防止重放攻擊。建議攜帶此參數進一步提升API安全性。 sign_type=hmacsha1時此參數有效。	客戶自行生成隨機正整數，如random.randint(1, 100000000)
region	是	國家編碼	國家編碼，例如：US，IN

3. 調用示例

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

SecretId：o1fjh1re9o28876h7c08
SecretKey：jd1gzm6ant2u7pojhbtl0bam0xpzsm1c

以密鑰令牌驗證為例，調用獲取密鑰令牌接口得到密鑰令牌：

SecretToken：oxf0n0g59h7wcdyvz2uo68ph2s

調用示例

獲取美國的州編碼

GET https://dev.kdlapi.com/api/getfpsareacode?secret_id=o1fjh1re9o28876h7c08
&signature=oxf0n0g59h7wcdyvz2uo68ph2s
&region=US

使用說明

點擊查看關于API授權與驗證的介紹

4. 返回結果

接口返回json格式，樣例：

{
  "msg": "",
  "code": 0,
  "data": [
    "Arizona", "Utah", "Virginia", "Minnesota", "North Carolina", "Ohio", "Wisconsin", "Kansas", 
    "South Carolina", "Nebraska", "Indiana", "Washington", "Hawaii", "Montana", "Idaho", "West Virginia",
    "New Hampshire", "Oregon", "Colorado", "Alabama", "Connecticut", "New York", "Delaware", "Maryland",
    "Texas", "California", "Georgia", "Florida", "Massachusetts", "Arkansas", "New Mexico", "New Jersey",
    "Pennsylvania", "Nevada", "North Dakota", "Tennessee", "Kentucky", "Mississippi", "Illinois", "Missouri",
    "Oklahoma", "Michigan", "Vermont", "Wyoming", "Rhode Island", "Louisiana", "Maine", "District of Columbia",
    "Iowa", "Alaska", "South Dakota"
  ]
}

異常返回格式樣例：

{"code": -1, "msg": "參數錯誤", "data": ""}

輸入的國家查詢不到編碼時返回：

{ "msg": "", "code": 0, "data": [] }

5. 錯誤碼一覽

錯誤碼	說明
-1	缺少參數

6. SDK

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

SDK下載