Chaitin Tech 资产/IP地址 API
The 资产/IP地址 API from Chaitin Tech — 9 operation(s) for 资产/ip地址.
OpenAPI Specification
openapi: 3.0.3
info:
title: APISec Management account 资产/IP地址 API
version: '26.05'
description: Generated from APISec skyview APIView classes.
tags:
- name: 资产/IP地址
paths:
/v1/asset/ip:
get:
deprecated: false
description: ''
parameters:
- description: 空间ID
example: '1'
in: query
name: space
required: true
schema:
type: string
- description: 状态
example: valid
in: query
name: status
required: true
schema:
enum:
- valid
- await
- ignored
- invalid
type: string
x-apifox-enum:
- description: 已确认
name: ''
value: valid
- description: 待确认
name: ''
value: await
- description: 已排除
name: ''
value: ignored
- description: 历史记录
name: ''
value: invalid
- description: 排序字段，字段前加-表示降序，默认排序为-id
example: ''
in: query
name: sort
required: false
schema:
type: string
- description: 页码
example: 1
in: query
name: page
required: false
schema:
type: integer
- description: 分页大小
example: 20
in: query
name: size
required: false
schema:
type: integer
- description: IP
example: ''
in: query
name: ip
required: false
schema:
type: string
- description: ASN编号
example: ''
in: query
name: as_num
required: false
schema:
type: string
- description: 运营商
example: ''
in: query
name: provider
required: false
schema:
type: string
- description: 位置
example: ''
in: query
name: location
required: false
schema:
type: string
- description: 来源
example: dns
in: query
name: source
required: false
schema:
type: string
- description: 分组
example: ''
in: query
name: bu
required: false
schema:
type: string
- description: 标签
example: ''
in: query
name: tag
required: false
schema:
type: string
- description: 首次发现开始时间，格式为`2023-01-01 00:00:00`，配合created_at_before使用
example: ''
in: query
name: created_at_after
required: false
schema:
type: string
- description: 首次发现结束时间，格式为`2023-01-01 00:00:00`，配合created_at_after使用
example: ''
in: query
name: created_at_before
required: false
schema:
type: string
- description: 最后发现开始时间，格式为`2023-01-01 00:00:00`，配合lastseen_at_before使用
example: ''
in: query
name: lastseen_at_after
required: false
schema:
type: string
- description: 最后发现结束时间，格式为`2023-01-01 00:00:00`，配合lastseen_at_after使用
example: ''
in: query
name: lastseen_at_before
required: false
schema:
type: string
responses:
'200':
content:
application/json:
example:
code: 200
data:
current: 1
items:
- as_name: ALIBABA-CN-NET Hangzhou Alibaba Advertising Co.,Ltd., CN
as_num: AS37963
bu: ''
city: 北京市
country: 中国
created_at: '2025-06-13 11:45:42'
id: 3210499
ip: 47.95.29.9
lastseen_at: '2025-06-13 11:45:42'
live_port: 0
location: 中国 北京市 北京市
provider: 阿里云
province: 北京市
sources:
- factor: 443,9000
lastseen_at: '2025-06-13 11:45:42'
reason: chaitin.com
source: 证书
status: await
subnet: 47.95.29.0/24
tags: []
updated_at: '2025-06-13 11:45:42'
version: 4
size: 20
total: 1
message: ''
schema:
properties:
code:
title: 响应码
type: integer
data:
properties:
current:
title: 当前页码
type: integer
items:
items:
properties:
as_name:
title: ASN名称
type: string
as_num:
title: ASN编号
type: string
bu:
title: 分组
type: string
city:
title: 城市
type: string
country:
title: 国家
type: string
created_at:
title: 创建时间
type: string
id:
title: ID
type: integer
ip:
title: IP
type: string
lastseen_at:
title: 最后发现时间
type: string
live_port:
title: 存活端口数
type: integer
location:
title: 位置
type: string
provider:
title: 运营商
type: string
province:
title: 省份
type: string
sources:
items:
properties:
factor:
title: 命中情况
type: string
lastseen_at:
title: 最后发现时间
type: string
reason:
title: 发现依据
type: string
source:
title: 来源
type: string
required:
- source
- reason
- factor
- lastseen_at
type: object
x-apifox-orders:
- source
- reason
- factor
- lastseen_at
title: 来源列表
type: array
status:
title: 状态
type: string
subnet:
nullable: true
title: 网段
type: string
tags:
items:
properties:
name:
title: 标签名称
type: string
pk:
title: 标签ID
type: integer
required:
- pk
- name
type: object
x-apifox-orders:
- pk
- name
title: 标签列表
type: array
updated_at:
title: 更新时间
type: string
version:
title: IP版本
type: integer
required:
- id
- ip
- version
- subnet
- status
- live_port
- provider
- as_name
- as_num
- location
- country
- province
- city
- sources
- tags
- bu
- created_at
- updated_at
- lastseen_at
type: object
x-apifox-orders:
- id
- ip
- version
- subnet
- status
- live_port
- provider
- as_name
- as_num
- location
- country
- province
- city
- sources
- tags
- bu
- created_at
- updated_at
- lastseen_at
type: array
size:
title: 分页大小
type: integer
total:
title: 总数
type: integer
required:
- current
- size
- total
- items
title: 数据
type: object
x-apifox-orders:
- current
- size
- total
- items
message:
title: 消息
type: string
required:
- code
- message
- data
type: object
x-apifox-orders:
- code
- message
- data
description: ''
headers: {}
x-apifox-name: 成功
security:
- apikey-header-TOKEN: []
summary: IP地址列表
tags:
- 资产/IP地址
x-apifox-folder: 资产/IP地址
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/4506488/apis/api-181531222-run
/v1/asset/ip/batch-create:
post:
deprecated: false
description: ''
parameters:
- description: 空间ID
example: '1'
in: query
name: space
required: false
schema:
type: string
requestBody:
content:
application/json:
example:
assets:
- 39.99.137.217
bu_id: 4
tags:
- aaa
- bbb
schema:
properties:
assets:
items:
type: string
title: ip列表
type: array
bu_id:
title: 分组ID
type: integer
tags:
items:
type: string
title: 标签数组
type: array
required:
- assets
type: object
x-apifox-orders:
- assets
- bu_id
- tags
responses:
'200':
content:
application/json:
example:
code: 200
data:
affected: 1
ignored: 0
message: ''
schema:
properties:
code:
title: 响应码
type: integer
data:
properties:
affected:
title: 成功的数量
type: integer
ignored:
title: 忽略的数量
type: integer
required:
- affected
- ignored
title: 数据
type: object
x-apifox-orders:
- affected
- ignored
message:
title: 消息
type: string
required:
- code
- message
- data
type: object
x-apifox-orders:
- code
- message
- data
description: ''
headers: {}
x-apifox-name: 成功
security:
- apikey-header-TOKEN: []
summary: IP地址批量添加
tags:
- 资产/IP地址
x-apifox-folder: 资产/IP地址
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/4506488/apis/api-181531489-run
/v1/asset/ip/batch-delete:
delete:
deprecated: false
description: ''
parameters:
- description: 空间ID
in: query
name: space
required: false
schema:
type: integer
requestBody:
content:
application/json:
schema:
properties:
pk:
items:
type: integer
title: ID列表
type: array
required:
- pk
type: object
x-apifox-orders:
- pk
responses:
'200':
content:
application/json:
example:
code: 200
data:
affected: 0
ignored: 1
message: ''
schema:
properties:
code:
title: 响应码
type: integer
data:
properties:
affected:
title: 成功的数量
type: integer
ignored:
title: 忽略的数量
type: integer
required:
- affected
- ignored
title: 数据
type: object
x-apifox-orders:
- affected
- ignored
message:
title: 消息
type: string
required:
- code
- message
- data
type: object
x-apifox-orders:
- code
- message
- data
description: ''
headers: {}
x-apifox-name: 成功
security:
- apikey-header-TOKEN: []
summary: IP地址批量删除
tags:
- 资产/IP地址
x-apifox-folder: 资产/IP地址
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/4506488/apis/api-181531310-run
/v1/asset/ip/bu:
post:
deprecated: true
description: ''
parameters:
- description: 空间ID
example: '1'
in: query
name: space
required: false
schema:
type: string
requestBody:
content:
application/json:
example:
bu_id: 3
pk:
- 20350
- 17160
schema:
properties:
bu_id:
title: 分组ID
type: integer
pk:
items:
type: integer
title: ip id列表
type: array
required:
- pk
- bu_id
type: object
x-apifox-orders:
- pk
- bu_id
responses:
'200':
content:
application/json:
example:
code: 200
data:
affected: 2
ignored: 0
message: ''
schema:
properties:
code:
title: 响应码
type: integer
data:
properties:
affected:
title: 成功的数量
type: integer
ignored:
title: 忽略的数量
type: integer
required:
- affected
- ignored
title: 数据
type: object
x-apifox-orders:
- affected
- ignored
message:
title: 消息
type: string
required:
- code
- message
- data
type: object
x-apifox-orders:
- code
- message
- data
description: ''
headers: {}
x-apifox-name: 成功
security:
- apikey-header-TOKEN: []
summary: IP地址批量关联分组
tags:
- 资产/IP地址
x-apifox-folder: 资产/IP地址
x-apifox-status: deprecated
x-run-in-apifox: https://app.apifox.com/web/project/4506488/apis/api-248741022-run
/v1/asset/ip/status:
post:
deprecated: false
description: ''
parameters:
- description: 空间ID
example: 1
in: query
name: space
required: false
schema:
type: integer
requestBody:
content:
application/json:
example:
pk:
- 17160
status: valid
schema:
properties:
pk:
items:
type: integer
title: ID列表
type: array
status:
enum:
- valid
- await
- ignored
- invalid
title: 状态
type: string
x-apifox:
enumDescriptions:
await: 待确认
ignored: 已排除
invalid: 历史记录
valid: 已确认
required:
- pk
- status
type: object
x-apifox-orders:
- pk
- status
responses:
'200':
content:
application/json:
example:
code: 200
data:
affected: 1
ignored: 0
message: ''
schema:
properties:
code:
title: 响应码
type: integer
data:
properties:
affected:
title: 成功的数量
type: integer
ignored:
title: 忽略的数量
type: integer
required:
- affected
- ignored
title: 数据
type: object
message:
title: 消息
type: string
required:
- code
- message
- data
type: object
description: ''
headers: {}
x-apifox-name: 成功
security:
- apikey-header-TOKEN: []
summary: IP地址批量修改状态
tags:
- 资产/IP地址
x-apifox-folder: 资产/IP地址
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/4506488/apis/api-181531260-run
/v1/asset/ip/tag:
delete:
deprecated: true
description: ''
parameters:
- description: 空间ID
example: '1'
in: query
name: space
required: false
schema:
type: string
requestBody:
content:
application/json:
example:
pk:
- 20350
- 17160
tag:
- xxx
- yyy
schema:
properties:
pk:
items:
type: integer
title: ip id列表
type: array
tag:
items:
type: string
title: 标签列表
type: array
required:
- pk
- tag
type: object
x-apifox-orders:
- pk
- tag
responses:
'200':
content:
application/json:
example:
code: 200
data: {}
message: ''
schema:
properties:
code:
title: 响应码
type: integer
data:
properties: {}
type: object
message:
title: 消息
type: string
required:
- code
- message
- data
type: object
description: ''
headers: {}
x-apifox-name: 成功
security:
- apikey-header-TOKEN: []
summary: IP地址批量解绑标签
tags:
- 资产/IP地址
x-apifox-folder: 资产/IP地址
x-apifox-status: deprecated
x-run-in-apifox: https://app.apifox.com/web/project/4506488/apis/api-248753206-run
post:
deprecated: true
description: ''
parameters:
- description: 空间ID
example: '1'
in: query
name: space
required: false
schema:
type: string
requestBody:
content:
application/json:
example:
pk:
- 20350
- 17160
tag:
- xxx
- yyy
schema:
properties:
pk:
items:
type: integer
title: ip id列表
type: array
tag:
items:
type: string
title: 标签列表
type: array
required:
- pk
- tag
type: object
x-apifox-orders:
- pk
- tag
responses:
'200':
content:
application/json:
example:
code: 200
data: 4
message: ''
schema:
properties:
code:
title: 响应码
type: integer
data:
title: 绑定标签数量
type: integer
message:
title: 消息
type: string
required:
- code
- message
- data
type: object
x-apifox-orders:
- code
- message
- data
description: ''
headers: {}
x-apifox-name: 成功
security:
- apikey-header-TOKEN: []
summary: IP地址批量绑定标签
tags:
- 资产/IP地址
x-apifox-folder: 资产/IP地址
x-apifox-status: deprecated
x-run-in-apifox: https://app.apifox.com/web/project/4506488/apis/api-248748509-run
/v1/asset/ip/{pk}/tag:
post:
deprecated: false
description: ''
parameters:
- description: IP ID
example: 20350
in: path
name: pk
required: true
schema:
type: integer
- description: 空间ID
example: '1'
in: query
name: space
required: false
schema:
type: string
requestBody:
content:
application/json:
example:
tag:
- xxx
- yyy
schema:
properties:
tag:
items:
type: string
title: 标签列表
type: array
required:
- tag
type: object
x-apifox-orders:
- tag
responses:
'200':
content:
application/json:
example:
code: 200
data: {}
message: ''
schema:
properties:
code:
title: 响应码
type: integer
data:
properties: {}
type: object
message:
title: 消息
type: string
required:
- code
- message
- data
type: object
description: ''
headers: {}
x-apifox-name: 成功
security:
- apikey-header-TOKEN: []
summary: IP地址更新标签
tags:
- 资产/IP地址
x-apifox-folder: 资产/IP地址
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/4506488/apis/api-248756455-run
/v2/asset/ip/bu:
post:
deprecated: false
description: ''
parameters:
- description: 空间ID
example: '1'
in: query
name: space
required: false
schema:
type: string
requestBody:
content:
application/json:
example:
assets:
- 104.21.86.215
bu_id: 0
conflict: submit
schema:
properties:
assets:
items:
type: string
title: ip列表
type: array
bu_id:
description: 0表示未分组资产
title: 分组ID
type: integer
conflict:
description: 反向查询域名解析记录
enum:
- submit
nullable: true
title: 关联域名同步分组
type: string
x-apifox-enum:
- description: ''
name: 反向查询
value: submit
required:
- assets
- bu_id
type: object
x-apifox-orders:
- assets
- bu_id
- conflict
responses:
'200':
content:
application/json:
example:
code: 200
data:
affected: 2
ignored: 0
message: ''
schema:
properties:
code:
title: 响应码
type: integer
data:
properties:
affected:
title: 成功的数量
type: integer
ignored:
title: 忽略的数量
type: integer
required:
- affected
- ignored
title: 数据
type: object
x-apifox-orders:
- affected
- ignored
message:
title: 消息
type: string
required:
- code
- message
- data
type: object
x-apifox-orders:
- code
- message
- data
description: ''
headers: {}
x-apifox-name: 成功
security:
- apikey-header-TOKEN: []
summary: IP地址批量关联分组-v2
tags:
- 资产/IP地址
x-apifox-folder: 资产/IP地址
x-apifox-status: developing
x-run-in-apifox: https://app.apifox.com/web/project/4506488/apis/api-351241227-run
/v2/asset/ip/tag:
delete:
deprecated: false
description: ''
parameters:
- description: 空间ID
example: '1'
in: query
name: space
required: false
schema:
type: string
requestBody:
content:
application/json:
example:
assets:
- 104.21.86.215
conflict: submit
tag:
- xxx
- yyy
schema:
properties:
assets:
items:
type: string
title: ip列表
type: array
conflict:
description: 反向查询域名解析记录
enum:
- submit
nullable: true
title: 关联域名同步移除标签
type: string
x-apifox-enum:
- description: ''
name: 反向查询
value: submit
tag:
items:
type: string
title: 标签列表
type: array
required:
- assets
- tag
type: object
x-apifox-orders:
- assets
- tag
- conflict
responses:
'200':
content:
application/json:
example:
code: 200
data: 4
message: ''
schema:
properties:
cod
# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/chaitin/refs/heads/main/openapi/chaitin-ip-api-openapi.yml