Skip to main content

kuaidaili api sdk python, site: https://www.kuaidaili.com

Project description

快代理api SDK

依赖环境

  1. python2.7 到 python3.7

  2. 快代理 购买相应产品

  3. 获取订单的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 -o get-pip.py; python get-pip.py

您还可以参考 pip官网 进行安装。

通过源码包安装

前往 Github 代码托管地址 下载最新代码,解压后:

$ cd api-sdk
$ python setup.py install

示例

以私密代理订单使用为例:

# -*- coding: utf-8 -*-

"""
   私密代理使用示例
   接口鉴权说明:
   目前支持的鉴权方式有 "simple" 和 "hmacsha1" 两种,默认使用 "simple"鉴权。
   所有方法均可添加关键字参数sign_type修改鉴权方式。
"""

import kdl

auth = 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 组成的dict
ips = 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目录下找到更详细的示例

参考资料

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kdl-0.2.4.tar.gz (6.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page