# 奔富IP API 能做什么？六个接口管线路

> 来源网页：https://socks5ip.com.cn/guoneiip/benfuip/benfuip-api-liuge-jiekou-xianlu-guanli/
> 发布日期：2026-09-24
> 更新时间：2026-10-14

**六个接口里，只有一个是用来取 IP 的。奔富IP 的开放接口（文档版本 1.0.2，服务器地址 api.benfuip.com）把一条线路的整个生命周期都放了出来：取线、换线、写备注、改密码、解绑，外加一个查代理商 ID 的口子。**

这意味着脚本能做的事不再只是”批量拿 IP 然后手动填进工具”，而是把线路当成可编程资源——自己发现异常、自己换、自己记账。真正稀缺的不是”有 API”，而是把取线之外的那四个动作也开放出来。

🔗 快速入口：[一站式注册入口（24 家平台开通与续费）](https://linkdd.cn/socks5ip) ｜ [奔富IP 价格表（全档位）](https://socks5ip.com.cn/jiagebiao/benfujiasuqijiagebiaoduxiangyouxisocks5xianludizhi26yuanyue/) ｜ [奔富IP 使用教程（提取与配置）](https://socks5ip.com.cn/guoneiip/benfujiasuqijiaochengsocks5l2tpxieyitiqushiyongzhinanzhichir/)

📌 一句话结论

奔富IP 的 API 一共 **6 个接口**，用 **userid + apikey** 认证、全部支持 GET 与 POST。取线接口能按协议、线路 ID、备注三个维度筛；换线接口用 **cityid** 控制换到哪（0 随机 / -1 随机 P / -2 随机 T / -3 随机 G / -999 同城 / 大于 0 指定城市）；剩下的备注、改密、解绑、代理商 ID 四个接口，是把线路当资产来管的关键。**接口出错也返回 HTTP 200**，必须判 `errcode`。密钥需联系客服开通，等于账号权限，不能放进前端。

| 接口数量 / 文档版本
| 6 个 / v1.0.2

| 认证方式
| userid + apikey

| 能管到的最远一步
| 解绑线路 / 查代理商 ID

| 最容易被忽略的一点
| 失败信息在 HTTP 200 的 body 里

| 起步月卡档（参考）
| 2.6 元/月起

数据来源：奔富IP 官方 API 文档 v1.0.2（更新日期 2025-06-11）与站内价格表 ｜ 接口行为经实测 ｜ 最后更新：2026-09-24

### 六个接口里，只有一个是”取 IP”的

把六个接口摊开看，职责分得很干脆：一个负责读，五个负责改。读的那个就是平时最常用的取线接口，剩下五个分别管换线、改备注、改密码、解绑，以及查你自己账号的代理商 ID。全部走同一个服务器地址、同一套 userid + apikey 认证，参数都以 GET 或 POST 提交。

| 接口
| 做什么
| 关键参数

| ipuserList
| 读取账号下的线路列表
| pt / ipid / remark（都可选）

| ipuserChangeCity
| 把某条线路换到别的地区
| ipid + cityid

| ipuserSetRemark
| 给线路写备注
| ipid + remark

| ipuserSetPassword
| 改线路的连接密码
| ipid + newpass

| ipuserUnbind
| 解绑线路
| ipid

| getAgentid
| 查账号的代理商 ID
| 无额外参数

先记住这个比例：六个口子只占一个”读”，说明它从一开始就是按”管线路”而不是”取一次数据”设计的。这也是它与只提供提取能力的接口最本质的差别——后者取完就断了，线路后来发生了什么，脚本一无所知。

### 取线接口真正好用在哪：三个过滤条件

取线接口的返回值里有九个字段，其中 `host`、`port`、`ipid`、`pwd` 是拿来连的，`outip`（出口 IP）、`enddate`（过期日期）、`cityid` / `cityname`（地区）与 `remark`（备注）是拿来判断的。真正省事的地方在三个可选过滤参数上：不想全量拉回来再自己筛，直接在请求里指定就能只拿你要的那一批。

| 返回字段
| 实际用途

| outip
| 和上次记录比对，判断线路是否被系统换过出口

| enddate
| 提前几天列出即将过期的线路，避免跑到一半断线

| cityid / cityname
| 核对线路当前落在哪个地区，与业务要求是否一致

| remark
| 配合过滤参数，把线路按业务分组取回

| pt
| 按协议筛：socks5 / http / pptp / l2tp / sstp 五种可选

把它接成一个每天跑一次的巡检脚本，只需要四件事：拉全量列表、比对 `outip` 有没有变、算 `enddate` 还剩几天、把异常线路记进日志。这一步不需要任何”AI 判断”，纯字段对比就能把”线路悄悄换过”和”快到期忘了续”这两类事故提前拦下来。

### 换线接口的关键在 cityid 怎么取

换线接口之所以值得单独讲，是因为它的参数 `cityid` 用一套约定值覆盖了五种完全不同的换线意图。不把这几个值背下来，很容易写出”每十分钟换一次、每次都换到随机地区”的脚本——那既浪费额度，也会让业务侧的出口频繁漂移。

| cityid
| 含义
| 什么时候用

| 0
| 随机
| 只要求”换个出口”，不在意落在哪个地区

| -1
| 随机 P 节点
| 要住宅拨号型出口，接受地址不固定

| -2
| 随机 T 节点
| 要稳定型出口，不挑具体城市

| -3
| 随机 G 节点
| 偏游戏/低延迟场景；文档注明部分套餐不可用

| -999
| 相同城市切换
| 业务要求”城市不变、只换地址”，最省心的一个值

| 大于 0
| 指定城市
| 有明确目标地区，比如要固定在某市

这套取值让”触发式换线”变得可行：不要按时间盲换，而是在业务侧收到明确信号（连续请求被拒、页面出现验证、延迟突破阈值）时，才调用一次换线接口，并且按业务性质选 `-999` 或 `-1`。这样一来，换线次数花在真正需要的时候，出口也不会无意义地满地图乱跳。至于线路本身的切换额度怎么算，站内那篇[动态与静态切换、分组管理教程](https://socks5ip.com.cn/guoneiip/benfuip/benfuip-dongtai-jingtai-qiehuan/)讲得比接口文档更细，值得先看一眼再动手写脚本。

### 把备注当业务编号，取线就能按业务筛

备注接口是最容易被当成”可有可无”的一个，但它其实是把接口用顺手的分水岭。原因在于取线接口支持按 `remark` 过滤——只要事先用改备注接口把线路打上标记，之后每次取线都能精确拿到某一批，而不是拉回全量再在代码里做字符串匹配。

| 业务场景
| 备注怎么写
| 取线时怎么调

| 多店铺 / 多窗口
| 店铺编号或窗口号，做到一店一线可追溯
| 按 remark 取回该店的线路，再写进对应窗口的配置

| 采集 / 抓取
| 按任务批次打标，例如任务名或批次日期
| 按 remark 拉本批次的线路池，失败任务单独换线

| 软路由 / 服务器
| 按设备或网段打标，标明这条线给谁用
| 定时拉取后直接重写分流规则，不用人工对照

| 测试与正式分离
| 测试线单独打一个前缀，避免混进生产池
| 按协议或备注分别取，测试线不参与正式任务

这里的顺序很关键：先写备注、再按备注取。反过来做，就只能每次把整个账号的线路全拉回来，靠代码去猜哪条属于哪个业务，一旦线路数量上去，维护成本会成倍增加。

### 改密码与解绑：把凭据轮换做成流程

剩下两个接口处理的是”线路凭据本身”的变化。改密码接口返回的是修改后的新密码，解绑接口返回的是操作结果——两者都属于低频但必须做的动作，最典型的三个触发点：设备或工具换手交接时把原凭据作废、怀疑凭据外泄时立即轮换、线路不再使用需要从账号里摘掉。

把它们写进流程的意义在于”有据可查”。手工改一次密码，事后很难说清改过哪些线路、改到什么时候；用接口做，同样的动作可以留下执行记录，配合备注里的业务标记，能直接回答”哪条线在什么时候被换过凭据”。

### 错误信息写在 HTTP 200 里，别只看状态码

这是实测出来、也最容易踩的一处：接口失败时，HTTP 状态码依然是 200，真正的原因写在返回体的 `errcode` 与 `msg` 里。成功是 `errcode` 为 “0”、同时带 `data`；失败是 `errcode` 为 “1”、`msg` 给出原因。

| 检查项
| 实测结果
| 说明

| 不带参数请求取线接口
| HTTP 200，内容为 errcode 1
| 状态码正常，错误在 body 里

| 不带参数请求代理商接口
| HTTP 200，内容为 errcode 1
| 同样的返回形态，需统一处理

| 带参数的正常请求
| errcode 0，data 内为业务数据
| 判断成功要看 errcode，不要看 HTTP 码

落到代码里就一句话：请求发出去之后，先看 `errcode`，为 “0” 才去读 `data`，否则把 `msg` 原样记进日志。反过来写（只看 HTTP 200 就当成功）会让脚本在参数写错的情况下继续往下跑，最后表现为”程序没报错，但线路一直连不上”，排查起来最费时间。

### 密钥等于账号权限，开通与保管都要走正规路径

每个奔富账号都可以有自己的独立密钥，但它不是自助生成的：需要[通过官方入口注册（邀请码 adminA1）](https://my.benfuip.com/user/login?p=adminA1)之后联系客服开通，客服微信 **17720135827**。开通后它就是账号级的凭据——拿到 userid 与 apikey 等于拿到这个账号下线路的读改权限。

因此有三条底线：密钥证书文件写死在服务端的定时脚本里，不要嵌进网页前端或手机客户端；不要提交到公开的代码仓库；不要把带密钥的完整请求链接贴进群聊或工单。至于一个账号能同时开几把密钥、密钥遗失后如何重新签发，这两点官方文档没有写明，直接问客服确认最稳。

| 保管动作
| 建议做法

| 存放位置
| 服务端环境变量或权限受限的配置文件

| 调用来源
| 只从自己的服务器发起，避免走公共网络环境

| 交接与轮换
| 人员或设备变动时重新签发，并同步轮换线路密码

| 异常处置
| 发现疑似外泄，先改账号密码并联系客服，必要时逐条解绑

### 官方入口与相关页面

| 用途
| 入口
| 说明

| 注册 / 开通密钥
| [官方注册入口（邀请码 adminA1）](https://my.benfuip.com/user/login?p=adminA1)
| 注册后联系客服申请 API 密钥

| 完整价格表
| [奔富IP 全档位价格表](https://socks5ip.com.cn/jiagebiao/benfujiasuqijiagebiaoduxiangyouxisocks5xianludizhi26yuanyue/)
| 2.6 元/月起的各档带宽与协议对照

| 使用教程
| [奔富IP 提取与配置教程](https://socks5ip.com.cn/guoneiip/benfujiasuqijiaochengsocks5l2tpxieyitiqushiyongzhinanzhichir/)
| Socks5 与 L2TP 的提取、软路由配置

| 切换与分组
| [动态与静态切换、分组管理教程](https://socks5ip.com.cn/guoneiip/benfuip/benfuip-dongtai-jingtai-qiehuan/)
| 理解换线额度与分组的实际行为

| 线路自测
| [IP 综合检测中心（免费）](https://socks5ip.com.cn/ip-check-center/)
| 验证接口取回的线路出口是否生效

### 常见问题

**Q：六个接口里，日常最常用的是哪一个？**
A：取线接口。它是唯一一个”读”的接口，其余五个都是在它拿到 `ipid` 之后才会用到的动作，所以实际写脚本时通常先调它，再从结果里挑出要处理的那条线路。

**Q：接口能把别的账号的线路也取出来吗？**
A：不能。认证参数是 userid 加 apikey，接口只作用于这组凭据对应的账号，返回的也是该账号名下的线路，不会跨账号读取。

**Q：换线时指定 -3 随机 G 节点，为什么有时会失败？**
A：文档明确写了”部分套餐不能使用 G 节点”。所以拿到失败返回时，先确认账号买的档位是否包含 G 节点，再去看网络或参数问题，顺序反过来会白排查很久。

**Q：接口返回失败，但 HTTP 状态码是 200，怎么判断？**
A：判返回体里的 `errcode`：为 “0” 才算成功并去读 `data`，为 “1” 就把 `msg` 记进日志。只看 HTTP 200 会让参数错误被静默放过。

**Q：没有 API 密钥，还能正常用奔富IP 吗？**
A：能。密钥是给批量与自动化场景准备的；电脑端、安卓 APP、老鱼加速器与软路由都可以用后台或客户端手动提取线路，日常单机使用不需要接口。

**Q：取线接口返回的 enddate 和 outip，具体能拿来做什么？**
A：做巡检。每天拉一次列表，比对 `outip` 是否与上次记录一致、算 `enddate` 还剩多少天，就能在”线路被换过出口”和”快到期”这两件事变成故障之前收到提示。

### 📚 相关阅读

📄 [奔富IP 的档位怎么分？价格阶梯一张表看懂（2.6 元/月起）](https://socks5ip.com.cn/guoneiip/benfuip/benfuip-dangwei-jiage-jieti/)

📄 [奔富IP动态和静态怎么切？线路切换与分组管理教程](https://socks5ip.com.cn/guoneiip/benfuip/benfuip-dongtai-jingtai-qiehuan/)

📄 [奔富IP vs 沧海IP，国内IP选哪个？5维对比](https://socks5ip.com.cn/guoneiip/benfu-vs-canghai-ip-comparison-2/)

🔗 直达：[奔富价格表](https://socks5ip.com.cn/jiagebiao/benfujiasuqijiagebiaoduxiangyouxisocks5xianludizhi26yuanyue/) ｜ [奔富使用教程](https://socks5ip.com.cn/guoneiip/benfujiasuqijiaochengsocks5l2tpxieyitiqushiyongzhinanzhichir/)

### 更多帮助

**如需获取更多帮助，请访问官网：[全网低价IP（socks5ip.com.cn）](https://socks5ip.com.cn/)**

📊 **[价格中心：24 家平台套餐价格横向对比（全部支持免费测试）](https://socks5ip.com.cn/jiagezhongxin/)**

📖 **[代理工具中心：Win/Android/iOS 客户端下载与配置教程](https://socks5ip.com.cn/dailigongjuzhongxin/)**

🛠️ **[IP综合检测中心：IP质量/线路/测速/业务模拟免费测](https://socks5ip.com.cn/ip-check-center/)**

📝 **聚合注册入口（24 家平台自助开通/续费/调换）：[https://linkdd.cn/socks5ip](https://linkdd.cn/socks5ip)**

💬 微信：**17720135827** — 7×24h在线

**全网低价IP｜聚合24家代理IP平台，全部免费测试，先测后买零风险**
