近期重要更新

2026年01月25日

重要静态 IP 认证安全机制升级公告

为了应对网络安全挑战，平台对静态 IP 的认证体系进行了底层重构。本次升级重点增强了凭证的随机性与商户间的数据隔离能力。

新增随机凭证模式： 支持生成高强度随机账号密码。
数据隔离增强： 彻底杜绝资源串号风险。

所需行动：请在 2026年1月28日前检查本地缓存策略。

优化核心性能与架构演进

我们对底层检索引擎进行了深度优化，大幅提升了高并发场景下的资源分配效率。

资源分配提速： 引入全新的覆盖索引技术，在高并发场景下，IP 资源提取响应时间（TTFB）缩短约 300%。
毫秒级地理检索： 重构了 IP 归属地检索引擎，现在按照“国家/省份”维度的筛选查询可实现毫秒级返回。
节点健康度监控： 引入全新的 Server Health Check 机制，系统将自动识别并标记低质量节点，自动剔除不稳定资源。

新增控制台体验与 API 文档变更

新增接口： POST /client/ip/pool/item/updateCreds (修改账密)。
新字段： security_score (安全评分)。
控制台： 新增实时资源消耗趋势图表。

2025年01月01日

重要 IpKingStar 平台全新上线

【里程碑】IpKingStar 全球代理网络正式发布，覆盖 190+ 国家和地区。
【新增】支持 HTTP/SOCKS5 双协议自动切换。
【新增】支持 USDT (TRC20) 自动充值通道。

IpKingStar API 文档

欢迎使用 IpKingStar API 文档。IpKingStar 是一个专业的基础网络的运营商，致力于为您提供最优质的代理服务和技术支持。
技术支持： 如在使用过程中遇到任何问题，请通过微信/telegram联系在线客服。

1. 认证方式

API 使用 API Key 进行认证。每个请求都需要在 HTTP Header 中包含您的 API Key。

Header 设置

# Header 示例
--header 'x-merchant-token: YOUR_TOKEN'
--header 'x-merchant-code: YOUR_CODE'
                

请求示例

fetch('/api/kton/simple/check', {
    headers: {
        'x-merchant-token': 'YOUR TOKEN',
        'x-merchant-code': 'YOUR CODE'
    }
})
                

安全建议：请妥善保管您的 API Key，不要在客户端代码中硬编码。如果怀疑泄露，请立即在控制面板重新生成。

2. 静态代理 API

静态代理服务提供固定IP地址的代理解决方案，支持多国家地区的IP资源。

GET/client/ip/pool/item/merchantIpList

查询已购买的静态 IP 详细信息。

参数名	必选	类型	描述
ip	否	String	IP地址筛选
status	否	Integer	状态: 1-已生效, 2-已过期, 3-已退订
type	否	Integer	IP类别: 0-广播, 1-原生
pageSize	否	Integer	每页显示记录数
pageNum	否	Integer	当前页码

GET/client/order/regionalAvailableIps

查询不同国家/地区的可用 IP 资源和价格。

{
  "code": 200,
  "msg": "查询成功",
  "rows": [
    {
      "id": 62,
      "type": 1,
      "continent": "North America",
      "countryCode": "MX",
      "location": "Yucatán",
      "price": 2.5,
      "ipTotals": 150
    }
  ],
  "total": 1
}
                

GET/client/merchant/walletInfo

查询当前商户账户的余额信息。

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "balance": 20.000,
    "totalAmount": 100.500
  }
}
                

POST/client/order/addStatic

创建购买静态 IP 的订单，支持批量混合购买。

参数名	必选	类型	说明
countryNums	是	Array	国家IP数量分配列表
monthCount	是	Long	购买时长（月）
currency	是	String	货币类型 (目前支持 USD)

Body 示例：

const response = await fetch('/client/order/addStatic', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'x-merchant-token': 'YOUR_TOKEN',
        'x-merchant-code': 'YOUR_CODE'
    },
    body: JSON.stringify({
        "countryNums": [{
            "countryCode": "US",
            "num": "2",
            "ipType": 1
        }],
        "monthCount": 1,
        "currency": "USD"
    })
});
                

POST/client/order/renewIpList

对已有 IP 进行续费。

参数名	必选	类型	说明
ipList	是	Array[String]	需要续费的 IP 地址列表
monthCount	是	Long	续费时长（月）

POST/client/order/unsubscribeStaticIps

退订指定的静态 IP。

body: JSON.stringify({
    "ipList": ["43.255.80.100"]
})
                

POST/client/payment/order/pay/{orderId}

使用订单 ID 完成支付流程。目前仅支持余额支付。

路径参数： orderId (下单接口返回的订单 ID)

{ "payment": "BALANCE" }

GET/client/order/orderList

查询静态代理订单列表，支持分页与状态筛选。

参数名	必选	类型	描述
status	否	Integer	订单状态 (0-未支付, 1-已支付, 2-已取消)
orderNo	否	String	订单号筛选

{
  "total": 2320,
  "rows": [
    {
      "id": 17316,
      "orderNo": "N2026012200163639310",
      "productName": "Static Regular",
      "quantity": 1,
      "totalAmount": 2.500,
      "currency": "USD",
      "status": 0,
      "paidStatus": 20,
      "orderItems": [
         {
            "id": 82384,
            "ip": "216.132.114.166",
            "countryCode": "US",
            "account": "sam5iOmh817ZLJ2"
         }
      ]
    }
  ]
}
                

POST/client/ip/pool/item/updateCreds NEW

修改指定静态 IP 的认证账号和密码（支持自定义或随机生成）。

参数名	必选	类型	说明
ip	是	String	目标IP地址
account	是	String	新账号
password	是	String	新密码

const response = await fetch('/client/ip/pool/item/updateCreds', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-merchant-token': 'TOKEN' },
    body: JSON.stringify({
        "ip": "192.168.1.100",
        "account": "newUser123",
        "password": "newPass456"
    })
});
                

3. 订单支付

POST/client/payment/order/pay/{orderId}

完成订单支付（目前仅支持余额支付 BALANCE）。

// 请求
POST /client/payment/order/pay/N2025032701271232584
Body: { "payment": "BALANCE" }
                

4. 错误码说明

错误码	描述
500	订单已失效
500	商户钱包余额不足
500	账户不存在

FAQ 常见问题

IP干净吗？

我们对出货的IP库进行了专项业务清洗，相对您的目标网站是可以保证干净的。

静态数据中心和静态住宅ISP有什么差别？

静态数据中心，是通过机房网络配置的代理线路，IP信息标记为机房IP。静态住宅ISP是本地运营商直连的网络，IP信息标记为非主机商的机构/家庭IP，具有更完善的真人属性。

通过域名连接和通过IP连接有什么不同？

一般情况下二者没有差别，建议使用域名连接。使用域名连接具有更高的稳定性，在连接地址不可用时，IpKingStar系统会自动为连接域名分配新连接IP，切换过程中用户无需修改任何配置。

动态IP的粘性是什么意思？

只要当前IP不失效，会一直保持不变（最高可能达到24小时）。在当前IP失效后，会自动切换。

动态流量包有使用期限吗？

有的。不同的流量包套餐有不同的使用期限，到期后剩余流量被清零。

我可以用你们线路翻墙吗？【不可以！！！】

不可以！IpKingStar 的线路已经屏蔽所有境内的IP访问，使用线路前，您需要自备境外环境。

你们支持API对接吗？

支持。具体对接内容可以查看 API 文档。

你们支持免费测试吗？

为了防止IP滥用，IpKingStar的静态产品目前并不提供任何免费测试服务。动态住宅线路，在用户注册激活后，可以领取免费流量包进行测试。

你们在线咨询客服时间支持24小时吗？

支持，点击官网右下角【在线咨询】按钮，即可直接在线咨询我司客服，全天候为您解答疑问。

为什么代理了IP却连接不上（或者没有网络）？

IpKingStar海外的IP需要在境外环境使用，国内环境无法使用。如果已经在境外环境仍连接不上，可以联系官方客服协助处理。

请问需要什么帮助？

前往 API 文档中心 >

在线咨询 (AI Robot)

IpKingStar 智能助手为您提供 7x24 小时服务。
支持查询 API 用法、订单状态及基础故障排查。

开始对话使用指南

人工咨询 (Human Support)

专业技术团队为您提供一对一支持。

Telegram @JUSTINHXW

WhatsApp Justin

工作日 9:00 - 19:00

认证与账户咨询

Q: 如何获取 API Key？
A: 登录控制台 -> API 设置页面生成。
Q: 请求头需要包含什么？
A: 必须包含 x-merchant-token 和 x-merchant-code。
Q: 如何充值余额？
A: 支持 USDT (TRC20) 自动充值，3分钟内到账。

查看账户接口

静态住宅代理咨询

Q: 如何购买静态 IP？
A: 调用 /client/order/addStatic 接口下单。
Q: IP 是独享的吗？
A: 是的，静态住宅代理提供固定且独享的 IP 资源。
Q: 支持哪些协议？
A: 支持 HTTP 和 SOCKS5 双协议自动切换。

查看下单接口

静态住宅代理与商务合作

Q: 静态住宅代理如何管理？
A: 提供一键复制网络代理链接功能。
Q: 如何成为合作伙伴？
A: 我们提供 SaaS 销售商机，欢迎联系 TG 洽谈。
Q: 网络代理到期后数据保留多久？
A: 停服后保留 3 天，请及时续费。

了解合作计划