跳至主要內容

python http代理ip接口API

熊大2024年4月17日python大约 8 分钟约 2366 字

快代理IP接口

proxy_ip.py

"""代理ip
官网：https://www.kuaidaili.com/
查看订单信息：https://www.kuaidaili.com/uc/order-list/
"""
import requests
import json
from typing import Literal, Union
import random
from django.core.cache import cache
from utils.location_info import main_city_dict


def get_kuaidaili_ip(location: Union[str, list, bool] = '', format: Literal['text', 'json'] = 'text', is_password: bool = True, is_display_location=False):
    """得到一个代理IP地址
    :param is_password: 返回时，是否添加密码信息（如果是白名单就不用添加）
    :param location: 地区（可输入省份名称或者城市名称），如果是城市列表代表在范围中随机选择，如果是字符串代表指定城市
    :param is_display_location: 是否返回地区，如果返回地区则是一个元组数据
    """
    if not location:
        return '', '' if is_display_location else ''
    elif isinstance(location, list):
        location = random.choice(location)
    elif location is True:
        location = random.choice(list(main_city_dict.values()))

    # 私密代理IP接口API：https://www.kuaidaili.com/doc/api/getdps/
    api_url = 'https://dps.kdlapi.com/api/getdps'

    # 查看订单API密钥：https://www.kuaidaili.com/uc/api/secret/
    params = {
        'secret_id': 'xxx',
        'signature': 'xxx',
        'num': 1,  # 数量,
        'area': location,  # 筛选地区（仅支持按IP付费订单），可支持格式示例：'湖北', '湖北省', '武汉', '武汉市', '北京省', '北京市'。不支持省市拼接一起的字符串。
        # 'f_loc': 1  # （测试使用）返回结果 添加地区信息，https://www.kuaidaili.com/doc/dev/china_area_code/#42
        # 'f_et': 1,  # （测试使用）返回结果 添加可用时间信息。这里测试与购买额度固定一致，就不用使用。
    }

    # 获取IP
    try:
        ip_response = requests.get(api_url, params=params)
    except Exception as e:
        print(e)
        return
    if ip_response.status_code != 200:
        return

    ip_str = ip_response.text  # 得到代理IP地址

    # 查看代理访问密码：https://www.kuaidaili.com/uc/dps/
    username = 'd4245106311'
    password = '8ybkdofj'

    # 是否将代理IP验证的账号密码一起输出
    if is_password:
        proxy_ip_info = f"{username}:{password}@{ip_str}"
    else:
        proxy_ip_info = ip_str

    # 返回格式为文本还是json
    if format == 'text':
        if is_display_location:
            return proxy_ip_info, location
        else:
            return proxy_ip_info
    else:
        proxies = {
            "http": f"http://{proxy_ip_info}/",
            "https": f"http://{proxy_ip_info}/"
        }
        if is_display_location:
            return {'proxies': proxies, 'location': location}
        else:
            return proxies


def get_kuaidaili_locations() -> list:
    """得到快代理支持的地区"""
    api_url = 'https://dps.kdlapi.com/api/dpsresources'
    params = {
        'secret_id': 'xxx',
        'signature': 'xxx',
    }

    # 缓存中获取可用地区
    city_list = cache.get('kuaidaili_city_list')
    if city_list:
        return city_list

    try:
        location_response = requests.get(api_url, params=params)
        data = location_response.json().get('data')
        city_list = {item['area_name'] for item in data}
        city_list = list(city_list)
        cache.set('kuaidaili_city_list', city_list, 60 * 10)
        return city_list
    except Exception as e:
        print(e)
        return []


def print_kuaidaili_location():
    """（测试使用）打印快代理支持的地区
    https://www.kuaidaili.com/doc/dev/china_area_code/
    将文件下载到当前目录并转换成xlsx格式
    """

    import pandas as pd
    import os

    # 加载Excel文件
    current_directory = os.path.abspath('.')
    file_path = os.path.join(current_directory, '中国地区编码表.xlsx')
    df = pd.read_excel(file_path)

    # 初始化一个字典来存储省份和对应的市名字
    province_city_dict = {}

    # 遍历DataFrame的每一行
    for index, row in df.iterrows():
        # 获取省份和城市名称
        province = row['省份']
        city = row['城市']

        # 如果城市名为“市辖区”，则认为是直辖市，将值设置为None
        # 否则，将城市名添加到对应省份的列表中
        if city == "市辖区":
            province_city_dict[province] = None
        else:
            province_city_dict.setdefault(province, []).append(city)

    # 移除重复的城市名字并转换字典为JSON字符串
    for province in province_city_dict:
        if province_city_dict[province] is not None:
            province_city_dict[province] = list(set(province_city_dict[province]))

    json_output = json.dumps(province_city_dict, ensure_ascii=False, indent=2)

    # 打印输出结果
    print(json_output)


if __name__ == '__main__':
    # 得到代理IP可用城市
    ip = get_kuaidaili_ip(location=True, is_display_location=True)
    print(ip)

    # 获取一个代理IP
    # proxies = get_kuaidaili_ip(format='json', location='海口市')
    # response = requests.get("http://dev.kdlapi.com/testproxy", proxies=proxies)
    # if response.status_code == 200:
    #     print(response.text)  # # 请勿使用keep-alive复用连接(会导致隧道不能切换IP)
    # else:
    # API公共错误码：https://www.kuaidaili.com/doc/dev/dpshttpresponse/
    # 私密代理错误信息：https://www.kuaidaili.com/doc/dev/dpshttpresponse/
    # print(response.status_code)

    # 获取中国地区编码：https://www.kuaidaili.com/doc/dev/china_area_code
    # get_kuaidaili_location()
懂生活，懂编程
Copyright © 2025 熊大