跳到主要内容

库存查询

鉴权:UserIdToken

购买前按条件查询可购数量;condition 结构与 购买 报价/下单一致。


1. 国家库存树

POST /open/staticip/inventory/countries

按洲/国家/城市返回可购数量。

Body:

字段类型必填说明
countryCodestring收窄单国;ALL 或不传表示不限
continentCodestring大洲代码
keywordstring匹配国家/城市名称
needInventorybooleantrue 返回 available(默认);false 轻量树,available 为 null
conditionobject购买条件试算,见下表

condition 字段:

字段类型必填说明
sellModenumber1 独享 / 2 共享
lineTypestringbasic / standard / premium
maxSharenumber共享上限,共享模式默认 10
allocateStrategynumber1 随机 / 2 指定段 / 3 指定 IP
businessIdstring业务用途 ID
isUdpboolean是否 UDP

响应 data 数组元素:

字段类型说明
continentIdstring大洲 ID
countryIdstring国家 ID
countryCodestring国家代码
nameZh / nameEnstring国名
availablenumber该国可购 IP 总数
citiesarray城市明细
cities[].cityIdstring城市 ID
cities[].nameZh / nameEnstring城市名
cities[].availablenumber城市可购数

2. CIDR 段库存

POST /open/staticip/inventory/cidrs

指定国家(及可选城市)下 CIDR 段列表及余量。

Body:

字段类型必填说明
countryCodestring国家代码
cityCodestring城市 ID 的字符串形式
keywordstringCIDR 关键词
conditionobject购买条件(同上)
sortobject排序
sort.fieldstringprice / stock
sort.directionstringasc / desc

响应 data 数组元素:

字段类型说明
cidrIdstringCIDR 资源主键
cidrstring网段,如 1.2.3.0/24
countryCodestring国家代码
cityIdstring城市 ID
nameZh / nameEnstring展示名称
availablenumber可用 IP 数
unitPricenumber单价
currencystring币种
ipCountnumber网段 IP 总数
cidrKeystring业务键(指定段下单用)
availableBitmapstring可用位图(指定 IP 时用)