1. 概览

欢迎使用 IpKingStar API 文档。IpKingStar 是一个专业的基础网络运营商，致力于为您提供优质代理服务和技术支持。

2026-01-25 更新：安全认证机制升级，新增随机凭证生成与修改接口，请关注 3.9 章节。

2. 认证方式

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

--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'
  }
})

3. 静态代理 API

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

认证检查

GET /simple/check

使用当前 Merchant Token 与 Merchant Code 检查认证是否可用。

3.1 查询已购买的静态 IP

GET /client/ip/pool/item/merchantIpList

3.2 查询可购资源

GET /client/order/regionalAvailableIps

{ "code": 200, "msg": "查询成功", "rows": [{ "id": 62, "type": 1, "countryCode": "MX" }], "total": 1 }

3.3 查询余额信息

GET /client/merchant/walletInfo

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

3.4 新购下单

POST /client/order/addStatic

{ "countryNums": [{ "countryCode": "US", "num": "2", "ipType": 1 }], "monthCount": 1, "currency": "USD" }

3.5 续费下单

POST /client/order/renewIpList

{ "ipList": ["1.1.1.1"], "monthCount": 1 }

3.6 退订资源

POST /client/order/unsubscribeStaticIps

{ "ipList": ["43.255.80.100"] }

3.7 订单支付

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

{ "payment": "BALANCE" }

3.8 查询订单列表

GET /client/order/orderList

3.9 修改认证信息 NEW

POST /client/ip/pool/item/updateCreds

{ "ip": "192.168.1.100", "account": "newUser123", "password": "newPass456" }

4. 错误码说明