快达利API SDK Python,网址:https://www.kuaidaili.com
kdl的Python项目详细描述
快代理api SDK
依赖环境
- python2.7 到 python3.7
- 从 快代理 购买相应产品
- 获取订单的orderId和apiKey
获取安装:
安装 Python SDK 前,请先获取订单对应的订单号和apiKey。 订单号是用于标识订单,apiKey 是用于加密签名字符串和服务器端验证签名字符串的密钥。apiKey 必须严格保管,避免泄露。
通过pip安装(推荐)
- 您可以通过 pip 将SDK安装到您的项目中:
- pip install kdl
- 如果您的项目环境尚未安装 pip ,可参考:
- Ubuntu/Debian安装pip:apt-get install python-setuptools
- CentOS安装pip:yum install python-setuptools
- MacOS安装pip: curl https://bootstrap.pypa.io/get-pip.py-oget-pip.py; python get-pip.py
您还可以参考 pip官网 进行安装。
示例
以私密代理订单使用为例:
# -*- coding: utf-8 -*-""" 私密代理使用示例 接口鉴权说明: 目前支持的鉴权方式有 "simple" 和 "hmacsha1" 两种,默认使用 "simple"鉴权。 所有方法均可添加关键字参数sign_type修改鉴权方式。 """importkdlauth=kdl.Auth("yourorderid","yourorderapikey")client=kdl.Client(auth)# 获取订单到期时间, 返回时间字符串expire_time=client.get_order_expire_time()print("expire time",expire_time)# 获取ip白名单, 返回ip列表ip_whitelist=client.get_ip_whitelist()print("ip whitelist",ip_whitelist)# 设置ip白名单,参数类型为字符串或列表或元组# 成功则返回True, 否则抛出异常client.set_ip_whitelist([])client.set_ip_whitelist("127.0.0.1, 192.168.0.139")print(client.get_ip_whitelist())client.set_ip_whitelist(tuple())# 提取私密代理ip, 第一个参数为提取的数量, 其他参数以关键字参数的形式传入(不需要传入signature和timestamp)# 具体有哪些参数请参考帮助中心: "https://help.kuaidaili.com/api/getdps/"# 返回ip列表# 注意:若您使用的是python2, 且在终端调用,或在文件中调用且没有加 "# -*- coding: utf-8 -*-" 的话# 传入area参数时,请传入unicode类型,如 area=u'北京,上海'ips=client.get_dps(2,sign_type='hmacsha1',format='json',pt=2,area='北京,上海,广东')print("dps proxy: ",ips)# 检测私密代理有效性: 返回 ip: true/false 组成的dictips=client.get_dps(2,sign_type='simple',format='json')valids=client.check_dps_valid(ips)print("valids: ",valids)# 获取计数版ip余额(仅私密代理计数版)balance=client.get_ip_balance(sign_type='hmacsha1')print("balance: ",balance)
您可以在examples目录下找到更详细的示例