# 烽讯IP 新增 API 文档与调用示例：用指令提 IP 怎么用

> 来源网页：https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-api-wendang-tiaoyong-shili/
> 发布日期：2026-10-13
> 更新时间：2026-10-14

**返回 txt 还是返回 json，这道选择题在烽讯IP 后台的「SK5 API 提取」页上排在最前面——它决定你拿到手的是能直接粘进工具的纯文本，还是要再解析一层的结构体。**

烽讯IP 新上线的「API 文档与调用示例」把这一步和后面四个控件一起摊开写清楚了：接口说明、请求参数、返回格式、错误码与注意事项，外加常见场景的调用示例与接入指引。线路价格从 2.6 元/月（SK5 1M 特惠档）起，10M 游戏档 6 元/月。

🔗 快速入口：[一站式注册入口](https://linkdd.cn/socks5ip) ｜ [烽讯IP价格表](https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-jiagebiao-2026/) ｜ [烽讯IP使用教程](https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-zhuce-jiaocheng/)

📌 一句话结论

烽讯IP 这次新增的不是一条线路，而是一套「让程序自己去提 IP」的说明：后台 **SK5 API 提取**页上先选订单，再依次定好返回格式、换行符、输出格式与服务器地址格式，点「生成API网址」拿到一条可长期调用的地址；旁边那个绿色入口「**API 文档与示例**」负责解释这条地址怎么用、返回什么、报错怎么看。页面上的选项是原文，字段级说明以该入口内的文档为准。

| 公告新增了什么
| API 文档 ／ 调用示例 ／ 接入指引，共三块

| 文档覆盖范围
| 接口说明、请求参数、返回格式、错误码及注意事项

| 提取页要配几项
| 五个：选择订单、返回格式、换行符、输出格式、服务器地址格式

| 价格起点
| SK5 1M 特惠档 2.6 元/月；10M 档 6 元/月

数据来源：烽讯IP 平台 2026-10-06 公告原文 ｜ 后台「SK5 API 提取」页选项与说明文字 ｜ 站内烽讯IP 价格表 ｜ 最后更新：2026-10-13

### 这个新入口，先解决「提取要手动点」这件事

烽讯IP 在 2026-10-06 发了条公告，标题是「平台新增 API 文档与调用示例，欢迎体验」。公告里写得很直白：新增的目的是「更好满足用户通过指令调用 API 的需求」，让大家快速了解接口能力、接入方式与调用流程。

它把内容拆成三块。第一块是 **API 文档**，涵盖接口说明、请求参数、返回格式、错误码及注意事项；第二块是 **调用示例**，给的是常见场景下的指令调用示例；第三块是 **接入指引**，用来帮用户完成鉴权、调用与调试流程。三块合起来，等于把原来要靠问客服、靠自己试的事情，落成了一份可以照着走的说明书。

入口在后台左侧菜单里，叫 **SK5 API提取**，位置在「SK5/HTTP管理」这一组下面。打开后页面右下角有一个绿色的「API 文档与示例」，就挨在蓝色「生成API网址」按钮的右边——这张图就是那个页面的实拍。

烽讯IP 后台「SK5 API 提取」页：左侧菜单进入，主区五个控件 + 右下角「API 文档与示例」入口

### 提取页上的五个控件，各锁死一样东西

页面第一眼看上去要素不少，但拆开只有五个控件，从上到下依次是选择订单、返回格式、换行符、输出格式、服务器地址格式。前一个决定「从哪个订单里取」，后面四个决定「取出来长什么样」。

| 控件
| 页面给出的可选项
| 它决定什么

| 选择订单
| 下拉选择项目名称
| 这次 API 从哪个已购订单里取 IP；下单这个前提不满足，这一项就没得选

| 返回格式
| txt ／ json
| 返回体的形态：按行读的纯文本，还是交给代码解析的结构化数据

| 换行符
| \n ／ br换行 ／ 空格分割
| 一次返回多条时，记录之间用什么符号隔开

| 输出格式
| 万象 ／ http
| 地址以哪一种书写形态给出（两个选项的具体差异，以「API 文档与示例」页的说明为准）

| 服务器地址格式
| 常规地址格式 ／ 固定域名
| 换节点之后，这条地址会不会跟着变

五个控件里，只有「选择订单」是必填——页面上它前面带一个红色星号，其余四项都有默认选中值，不改也能直接生成。所以第一次用的时候，真正需要动脑的其实是后面四项里的两三项。

### 返回格式与换行符：选错就得回来重配

这两项挨在一起，很容易当成一回事，其实管的是两个层面：**返回格式**管「整体是什么」，**换行符**管「记录之间怎么切」。前者只有 txt 和 json 两个选项，后者有三个。它们的区别用一句话说清：你打算把结果直接粘进工具，就偏向 txt；打算让脚本自己读，就偏向 json。

| 选择
| 拿到的形态
| 用之前先确认

| txt ＋ \n（换行符）
| 多条记录，每条独立一行
| 你的工具是不是按行读取；末尾那一行别被复制时漏掉

| txt ＋ br换行
| 多条记录，用 HTML 的换行标记分隔
| 目标环境认不认换行标记，纯文本编辑器里可能显示成一串字

| txt ＋ 空格分割
| 记录之间用空格隔开
| 记录内部本身有没有空格，有的话切分会串位

| json
| 结构化返回，字段由平台定义
| 字段名与类型看「API 文档与示例」，别按 txt 的顺序去猜

换行符这一项有个容易被忽略的点：它只影响「多条记录怎么排」。如果你这次只取一条，三种换行符看起来没差别，等业务扩到多条时才会暴露。所以如果打算长期用，建议一开始就按最终条数配，别等出问题再回来改。

### 服务器地址格式：常规地址还是固定域名

这一项是整个页面上唯一自带说明文字的，两个选项后面都跟了一段括号注释，把取舍讲得很清楚，直接照抄如下。

| 选项
| 页面原文说明
| 什么时候合适

| 常规地址格式
| 如果切换节点需要重新导出获取新的连接地址
| 换线比较频繁，每次都要拿到当前节点的真实地址

| 固定域名
| 切换节点域名不变，不适合频繁换线；本地电脑 DNS 缓存原因，换线后几分钟内本地电脑请求可能还是换线前的连接地址
| 地址要长期写死在业务配置里、不常换节点的场景

把两段注释连起来读，能得到一个很实用的判断：**「固定域名」是用「换线后可能有一段时间没生效」换来「地址不用改」**。如果你的业务是换 IP 之后立刻要验证新出口，选固定域名会被 DNS 缓存卡住几分钟；反过来，如果你的系统里地址是写死在配置里的，选常规地址格式就要留一条「重新导出并更新配置」的流程，否则换线了地址还指着旧的。

### 生成 API 网址就三步，拿到的是可长期调用的地址

配置项看着多，实际操作就三步，而且每一步都有明确的产出，不容易做错。

| 步骤
| 页面上的动作
| 这一步的产出

| 第一步
| 在「选择订单」下拉里选中一条已购项目
| 确定这次取 IP 的订单范围

| 第二步
| 依次定好返回格式、换行符、输出格式、服务器地址格式
| 确定这条地址返回什么形态的数据

| 第三步
| 点蓝色的「生成API网址」
| 拿到一条可以反复调用的地址

注意第三步的措辞是「生成网址」，不是「提取一次」。也就是说这一步产出的是一个**接口地址**，真正的取 IP 动作发生在你调用它的时候。这跟手动在后台点导出是两套逻辑：手动导出是点一次拿一次，API 是把「拿一次」这件事交给你自己的脚本或定时任务去触发。

这也解释了为什么页面上要让你提前把返回格式、换行符这些定下来——它们是写进那条网址里的参数，配好了就固定住，之后每次调用都按这个口径返回。要改口径，回来重新生成一条即可。

### 接入指引里的三件事：鉴权、调用与调试

公告里说的「接入指引」，具体落在三个环节上。它们分别对应「能不能调」「怎么调」「调不通怎么办」，走完一遍才算真接上。

| 环节
| 公告里对应哪一块内容
| 动手前要准备的东西

| 鉴权
| 接口说明 ＋ 请求参数
| 先确认这条网址是否自带凭据、凭据放在哪一段；以「API 文档与示例」页的接口说明为准

| 调用
| 调用示例
| 照常见场景的示例，把生成的 API 网址填进脚本或定时任务里

| 调试
| 错误码 ＋ 注意事项
| 对照错误码逐条排查；同时回头核对脚本里解析用的分隔符，跟页面上选的换行符是不是同一个

第三个环节最容易出问题，但原因往往不在平台侧。举个很常见的错配：页面上选了「br换行」，脚本里却按换行符 split，结果整段返回被当成一条记录——这种错在错误码里是看不出来的，只能靠核对两边的口径。所以调试这一环建议固定做两件事：先看错误码，再对一遍自己脚本的解析方式。

### 哪些活适合交给 API，哪些还是手动提更省

公告没说适用场景，但从这个页面的设计能推出来：它省掉的是「反复回后台点导出」这件事。所以分界线也在这里。

适合走 API 的，是**调用频次高、或者要接进自己系统**的活。比如同时挂着几个订单、需要定时换一批 IP、或者要把 IP 提取这一步并进已有的采集脚本里——这些场景里手动导出会变成每天重复的体力活，配一次 API 反而更省。特别是需要换线的业务，用 API 可以把「换线 → 取新地址」连成一条自动流程。

还是手动更省的情况同样清楚：只买了一条线路、偶尔换一次、对提取速度也没有要求。这种量级下配 API 的收益抵不过维护成本，直接在后台点两次导出就够了。

比较稳的过渡走法是：**先用短周期套餐手动跑一遍，确认线路和归属地符合预期之后，再把这个订单配成 API**。烽讯IP 的注册入口带免费测试，可以先测再决定要不要往 API 上迁；价格上 SK5 1M 特惠档 2.6 元/月，10M 游戏档 6 元/月，试错成本本来就不高。

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

| 需要的页面
| 入口

| 烽讯IP 价格表（SK5 五档与 L2TP 四档月付价全列）
| [烽讯IP价格表](https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-jiagebiao-2026/)

| 烽讯IP 官方注册入口（邀请码 adminA1 已内置）
| [https://www.fengxunip.com/user/login?p=adminA1](https://www.fengxunip.com/user/login?p=adminA1)

| 烽讯IP 注册＋使用教程（注册到 SK5/L2TP 配置全流程）
| [烽讯IP注册+使用教程](https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-zhuce-jiaocheng/)

| IP 综合检测中心（出口 IP、线路与测速免费自测）
| [IP综合检测中心](https://socks5ip.com.cn/ip-check-center/)

### 常见问题

**Q：烽讯IP 现在有 API 了吗？**
A：有。平台在 2026-10-06 发布了「新增 API 文档与调用示例」的公告，后台「SK5 API提取」页可以生成 API 网址，页面右下角的「API 文档与示例」是配套文档入口。

**Q：API 提取和手动导出 TXT 有什么区别？**
A：手动导出是点一次拿一次，人得守在后台；API 是先生成一条网址，之后由你的脚本或定时任务去调用。提取频次高、或者要接进自己系统的，用 API 更省事；只买一条线路偶尔换一次的，手动导出就够了。

**Q：返回格式该选 txt 还是 json？**
A：看你后面怎么用。直接粘进代理工具、按行读的，选 txt；交给脚本解析的，选 json。选 json 时字段名以「API 文档与示例」页的定义为准，不要按 txt 的顺序去猜。

**Q：换节点之后，之前生成的 API 网址还能用吗？**
A：取决于你在「服务器地址格式」上选了哪一项。选固定域名，地址不变（但页面写明换线后几分钟内本地电脑请求可能还是换线前的地址，DNS 缓存导致）；选常规地址格式，则切换节点后需要重新导出获取新的连接地址。

**Q：没有已购订单能生成 API 网址吗？**
A：不能。「选择订单」是页面上唯一标了红色星号的必填项，下拉里没有可选项时这一步走不下去。先完成下单，再回这个页面配置。

**Q：注册烽讯IP 时邀请码在哪填？**
A：通过站内的注册入口链接进入，邀请码 adminA1 已经带在链接里，不需要另外找输入框。价格按站内优惠价走，实测有出入可以联系客服核对。

### 📚 相关阅读

📄 [烽讯IP价格表：多带宽套餐全列（2026）](https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-jiagebiao-2026/)

📄 [烽讯IP 试用别只测通不通：额度该花在选档上](https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-shiyong-xuandang/)

📄 [烽讯IP适合游戏还是视频？2.6 元档到 28 元档怎么分](https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-youxi-shipin-dangwei/)

🔗 直达：[烽讯IP价格表](https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-jiagebiao-2026/) ｜ [烽讯IP使用教程](https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-zhuce-jiaocheng/)

### 更多帮助

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

📊 **[烽讯IP价格表（多带宽套餐全列）](https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-jiagebiao-2026/)**

📖 **[烽讯IP注册+使用教程](https://socks5ip.com.cn/guoneiip/fengxunjiasuqi/fengxunip-zhuce-jiaocheng/)**

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

📝 **烽讯IP官方注册入口（邀请码 adminA1）：[https://www.fengxunip.com/user/login?p=adminA1](https://www.fengxunip.com/user/login?p=adminA1)**

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

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