动态-API 提取 IP

按国家、时长与数量提取动态 IP；成功时响应体格式由 format 决定（1 文本、2 JSON）。

鉴权

所有渠道商接口均需在请求头中携带 accessKeySecret。密钥在渠道商管理平台中获取，并可根据需要重置。详见 通用信息。

接口描述

项目	说明
方法	POST
地址	https://api2.ipmart.io/custom/api/getIps
参考	https://api.ipmart.io/custom/api/getIps

输入参数

参数名称	必选	类型	描述
subUserId	是	String	子用户 ID
cntryCode	是	String	IP 所属国家代码（如 US）
time	是	Int	IP 有效时间（分钟），可填 5–30 任意整数
num	是	Int	提取个数，单次最大 1000
format	是	Int	返回格式：1 文本；2 JSON
apiCntryCode	否	String	API 服务器国家代码，默认 CA
stateName	否	String	IP 所属州名称
cityName	否	String	IP 所属城市名称

重要输出参数

参数名称	必选	类型	描述
—	—	—	成功时直接返回 IP 映射，格式由 format 决定（见返回示例）

发送示例

{
  "subUserId": "661f908102ca4953bc555a18",
  "apiCntryCode": "hk",
  "num": 1,
  "cntryCode": "us",
  "time": 10,
  "format": 2
}

返回示例

成功

{
  "10000": "8.217.249.213",
  "10001": "8.217.249.213"
}