获取产品库存

请求路径

/api/open/app/product/query/v2

请求参数

当主接口中的method为GetOrder时,该参数是主接口中的params参数

参数二级参数类型必填说明
proxyType-[]int是代理类型,详见字典
productNo-string否产品编号 如果传了产品编号,则只返回该编号对应的产品信息
countryCode-string否国家代码 可选
cityCode-string否城市代码 可选
supplierCode-string否供应商代码 可选
unit-int否时长单位,详见字典 可选
ispType-int否isp类型,详见字典 可选
duration-int否相对于时长单位的最小购买时长 可选

eg

{
    "proxyType":[103],
    "productNo":"productNo"
}

返回数据

参数二级参数类型必填说明
productNo-string是产品编号 保持唯一
productName-string否商品名 后续该字段逐步废弃,业务不应该依赖该字段。
proxyType-int16是代理类型,详见字段定义
useType-string是以(,)分割 1=账密 2=白名单 3=uuid 默认为1
protocol-string是1=socks5 2=http 3=https 4=ssh 默认是socks5
useLimit-int8是1=出口ip国外 2=出口ip国内 3=无限制
sellLimit-int8是1=大陆可售 2=海外可售 3=无限制
areaCode-string否区域code 动态代理没有区域,提取的时候查看动态代理支持的区域
countryCode-string是国家代码 3位 iso3
stateCode-string是州省代码 6位 000结尾要看citycode是否有值或者结尾,(有些小国家是没有州省级别的,但有城市区分)
cityCode-string是城市代码 9位 为空或者000 国家代码一致结尾表示只支持到上级 (有些国家城市即国家,比如新加坡)
detail-string否商品描述
costPrice-string是价格
inventory-int是库存
ipType-int否ip类型 1=ipv4 2=ipv6 3=随机 默认1
ispType-int否isp类型:1=单isp 2=双isp 0=未知默认
netType-int否网络类型:1=原生 2=广播 0=未知默认
duration-int是时长 0无限制
unit-int是单位 1=天 2=周(7天) 3=月(自然月) 4=年(自然年365,366)
bandWidth-int否带宽|流量时必要 单位 MB
bandWidthPrice-string否额外带宽价格
maxBandWidth-int否可设置最大带宽
flow-int否动态代理按照流量方式 最小购买和计价流量包 单位MB
cpu-int否cpu数
memory-float64否内存容量
enable-int8否是否可以购买 1可以 不为1表示该产品已下线,不可购买
supplierCode-string否供应商代码 后续该字段逐步废弃,业务不应该依赖该字段。
ipCount-int否动态代理按照ip数方式 最小购买和计价ip数 单位个
ipDuration-int否动态代理按照ip数方式 时长 单位分钟
assignIp-int否是否支持指定ip开通静态代理 1=是 -1=否 默认为-1
parentNo-string否父产品编号
cidrStatus-int否是否支持ip网段功能 1=是 -1=否 默认为-1
oneDay-int否是否支持1天购买 1是
cidrBlocks-array否支持网段及数量
-cidrstring否网段 比如 192.168.0.0/24
-countint否该网段数量
-asnstring否该网段属于哪个asn
-ispstring否该网段属于哪个运营商 比如ATT
-projectListarray否该网段项目列表
offlineCidrBlocks-array否最近1个月下架的网列表
-cidrstring否网段 比如 192.168.0.0/24
-offlineTimestring否网段下架时间 格式 2024-06-27 12:00:00
proxyEverytimeChange-int否动态代理账密提取 是否支持每次更换代理 1=是 -1=否 默认为否 新增于2025/08/14 部分动态代理产品支持
proxyGlobalRandom-int否动态代理提取 是否支持全球混播 1=是 -1=否 默认为否 新增于2025/08/14 部分动态代理产品支持
apiDrawGlobalRandom-int否动态代理Api提取是否支持全球混播 1=是 -1=否 默认为否 新增于2025/09/5 部分动态代理产品支持
ipWhiteList-int否动态代理是否支持IP白名单功能 1=是 -1=否 默认为否 新增于2025/09/5 部分动态代理产品支持
pwdDrawProxyUser-int否动态代理账密提取是否支持子账号 1=是 -1=否 默认为否 新增于2025/09/5 部分动态代理产品支持
proxyUserFlowLimit-int否动态代理子账号是否支持流量上限管理 1=是 -1=否 默认为否 新增于2025/09/5 部分动态代理产品支持
flowUseLog-int否动态代理是否支持流量明细查询 1=是 -1=否 默认为否 新增于2025/09/5 部分动态代理产品支持
pwdDrawSessionRange-string否动态代理账密流量提取持续时间范围 单位分钟 新增于2025/09/5 部分动态代理产品支持
flowConversionBase-int否动态代理流量进制转化基准 1000 或者 1024 0表示未知或不支持 新增于2025/09/5 部分动态代理产品支持
changeProxy-int否代理是否支持更换代理 1=支持 -1=不支持 默认不支持。调用更换代理接口前请以该字段为准,同时需渠道商已开通更换代理能力
projectList-array否产品项目列表
-codestring否项目code
-inventoryint否项目库存
productType-int否产品是共享还是独享 1=独享 2=共享 默认1
备注:
  • 只有enable = 1 且 inventory 大于 0 的产品可以购买
  • 产品列表的时长:duration 和单位:unit的结合,代表这款产品的最小时长
  • ip段如果上一次在产品里,这次拉去没有的话,代表该段已经下线,不可购买
  • 只返回有授权的产品;如果某一个产品之前授权过,后面取消授权,将不会返回,需要注意这种情况

eg:

  • duration=1 unit=1 表示最少购买1天
  • duration=1 unit=3 表示最少购买1个月
  • duration=30 unit=1 表示最少购买30天