快速开始指南

本指南带你走完从零到跑通第一个代理请求的全过程。核心只有一句话：接口链接是在用户中心点出来的，不用自己拼。

1. 注册并完成实名认证

访问 蜜蜂代理官网 注册账号。登录后完成实名认证——实名是使用服务（包括免费试用）的前提。

2. 获得一个短效代理订单

两条路，任选其一：

免费试用 —— 试用的前置条件是已完成实名认证，且每个账号只能试用一次（重复试用会提示「私密代理已试用，请购买服务」，该提示沿用了旧称，指的就是短效代理）。若登录用户中心后没有看到试用弹窗，请联系在线客服开通。试用订单的有效期、单次提取数与提取间隔，以【短效代理】订单页上显示的为准。

直接购买 —— 进入左侧菜单【短效代理】，点击右上角【购买】，选择 IP 提取数、提取间隔和时长。

无论哪条路，你都会在【短效代理】页面看到一条订单记录，形如：

订单号 61c1997d0b1cfa5ba828189a
付费内容  短效代理 IP提取数100-提取间隔5秒
有效时间  2034/01/01 01:01

这里的 IP提取数 和 提取间隔 很重要，后面所有的限制都由它们决定。

3. 添加白名单 IP

进入左侧菜单【白名单】，把要跑业务的那台机器的公网出口 IP 加进去。页面顶部会直接显示你当前的 IP，可以直接用。

这一步不能跳过，但它影响的不是下一步的 API 调用——不加白名单你照样能拿到 IP 列表，只是拿到的代理连不上。详见 白名单配置。

4. 生成 API 提取链接

这是最关键的一步：

1. 进入左侧菜单【短效代理】

2. 在你的订单那一行，点击【生成API】

3. 跳转到【生成短效代理 API 接口】页面，订单号已自动选好

4. 按需调整参数：

   表单项	建议
   提取数量	不超过订单的 IP 提取数，超出会被自动截断
   返回格式	改选 JSON —— 表单默认是「文本格式」，但出错时接口仍返回 JSON，格式会突变，程序更难处理
   换行符格式	只在文本格式下生效，用 JSON 时忽略即可

5. 点击【生成接口】，下方【生成结果】框里出现完整链接

6. 点击【复制链接】

复制到的链接形如：

https://api.beesproxy.com/api/v1/proxies/?order_id=YOUR_ORDER_ID&format=json&ip_num=100&user_token=YOUR_TOKEN

order_id 和 user_token 都已经填好了，你不需要去别处抄。

5. 调用链接获取代理 IP

这条链接就是一个普通的 HTTP GET 地址，直接请求即可：

import requests

# 从用户中心【复制链接】得到的完整地址
TARGET_URL = "https://api.beesproxy.com/api/v1/proxies/?order_id=...&format=json&ip_num=10&user_token=..."

resp = requests.get(TARGET_URL, timeout=10)
data = resp.json()

# 注意：出错时 HTTP 状态码同样是 200，必须检查 code 字段
if data.get("code") != 0:
    raise RuntimeError(f"获取代理失败：{data.get('message')}")

for p in data["result"]:
    print(f"{p['host']}:{p['port']}  ({p['city_cn']})")

成功时返回：

{
  "code": 0,
  "result": [
    { "host": "222.79.179.194", "port": "44966", "city_cn": "福建省泉州市石狮市" },
    { "host": "125.121.152.174", "port": "58337", "city_cn": "浙江省杭州市" }
  ]
}

6. 使用代理 IP 发送请求

取出 host 和 port，拼成 http://host:port 交给你的 HTTP 客户端：

import requests

proxy_url = "http://222.79.179.194:44966"
proxies = {"http": proxy_url, "https": proxy_url}

response = requests.get("https://httpbin.org/ip", proxies=proxies, timeout=10)
print(response.json())

如果这一步超时或连接被拒，先回头检查第 3 步的白名单。

常见的第一次踩坑

现象	原因
拿到了 IP，但代理连不上	白名单没加，或机器的出口 IP 变了
报 21003 调用频率过快	提取间隔由订单决定，不是固定 10 秒，看订单页显示的秒数
返回条数比请求的少	提取数超过订单上限会被截断；代理池临时不足时也会少给
返回的不是 JSON	生成器默认是文本格式，回第 4 步改选 JSON

下一步

• 查看 API 参考 了解完整的参数说明、响应格式和错误码
• 查看 代码示例 获取 Python / Node.js / Java 的完整示例
• 查看 Token 管理与安全 了解 user_token 的保管与重置