取消
最近搜索
清空历史

获取海外代理动态住宅地区编码

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下载

联系我们
  • 售前在线咨询
    咨询享免费测试,专业工程师提供技术支持
  • 客服热线: 400-058-0638
    周一至周五 09:00~21:00,周六09:00~18:30
  • 提交工单
    您的每一次反馈我们都认真对待
  • 客服企业微信 & QQ
    企微:点击此处 或扫码 QQ:800849628
  • 商务合作通道
    如需商务合作请通过专用通道联系我们