删除代理

删除不再需要的代理Token，支持单个删除和批量删除两种方式，删除后的Token可以通过恢复接口找回。

接口列表

接口	方法	描述
删除单个代理	DELETE	删除指定的单个代理Token
批量删除代理	DELETE	一次删除多个代理Token
恢复已删除代理	PUT	恢复误删除的代理Token
批量恢复代理	PUT	批量恢复已删除的代理Token

删除单个代理

删除指定的单个代理Token，删除后可通过恢复接口找回。

接口信息

项目	说明
接口地址	https://api.ipflex.ink/token/{token_id}
请求方法	DELETE
认证方式	Bearer Token（从后台获取）

请求参数

参数名	类型	必填	说明	示例
token_id	integer	是	Token ID（路径参数）	12345

提示

删除代理不会立即释放资源，在30天内可以通过恢复接口找回。

请求示例

cURL

curl -H "Authorization: Bearer YOUR_TOKEN" \
  -X DELETE \
  https://api.ipflex.ink/token/12345

Python

import requests

headers = {'Authorization': 'Bearer YOUR_TOKEN'}
token_id = 12345
response = requests.delete(
    f'https://api.ipflex.ink/token/{token_id}',
    headers=headers
)

print(response.json())

响应示例

{
  "status": "success",
  "message": "代理已删除",
  "data": {
    "token_id": 12345,
    "deleted_at": "2024-01-08T12:00:00Z",
    "can_restore": true,
    "restore_deadline": "2024-02-07T12:00:00Z"
  }
}

响应字段说明

字段	类型	说明
status	string	操作状态
message	string	操作消息
data.token_id	integer	被删除的Token ID
data.deleted_at	string	删除时间（ISO 8601格式）
data.can_restore	boolean	是否可以恢复
data.restore_deadline	string	可恢复的截止时间

---

批量删除代理

一次删除多个代理Token，适合清理大量不需要的代理。

接口信息

项目	说明
接口地址	https://api.ipflex.ink/token/batch
请求方法	DELETE
认证方式	Bearer Token（从后台获取）
Content-Type	application/json

请求参数

参数名	类型	必填	说明	示例
token_ids	array	是	Token ID列表（最多100个）	[12345, 12346, 12347]

请求示例

cURL

curl -H "Authorization: Bearer YOUR_TOKEN" \
  -X DELETE \
  -H "Content-Type: application/json" \
  -d '{
    "token_ids": [12345, 12346, 12347]
  }' \
  https://api.ipflex.ink/token/batch

Python

import requests

headers = {'Authorization': 'Bearer YOUR_TOKEN'}

response = requests.delete(
    'https://api.ipflex.ink/token/batch',
    headers=headers,
    json={
        'token_ids': [12345, 12346, 12347]
    }
)

print(response.json())

响应示例

{
  "status": "success",
  "message": "批量删除完成",
  "data": {
    "total_count": 3,
    "success_count": 3,
    "failed_count": 0,
    "failed_ids": [],
    "deleted_at": "2024-01-08T12:00:00Z"
  }
}

响应字段说明

字段	类型	说明
status	string	操作状态
message	string	操作消息
data.total_count	integer	请求删除的总数
data.success_count	integer	成功删除的数量
data.failed_count	integer	删除失败的数量
data.failed_ids	array	删除失败的Token ID列表
data.deleted_at	string	删除时间

---

恢复已删除代理

恢复误删除的单个代理Token，仅限删除后30天内的Token。

接口信息

项目	说明
接口地址	https://api.ipflex.ink/token/reset/{token_id}
请求方法	PUT
认证方式	Bearer Token（从后台获取）

请求参数

参数名	类型	必填	说明	示例
token_id	integer	是	Token ID（路径参数）	12345

注意

超过30天的已删除Token无法恢复，将被永久删除。

请求示例

cURL

curl -H "Authorization: Bearer YOUR_TOKEN" \
  -X PUT \
  https://api.ipflex.ink/token/reset/12345

Python

import requests

headers = {'Authorization': 'Bearer YOUR_TOKEN'}
token_id = 12345
response = requests.put(
    f'https://api.ipflex.ink/token/reset/{token_id}',
    headers=headers
)

print(response.json())

响应示例

{
  "status": "success",
  "message": "代理已恢复",
  "data": {
    "token_id": 12345,
    "restored_at": "2024-01-08T12:30:00Z",
    "token_info": {
      "ip": "203.0.113.42",
      "port": 8080,
      "status": "active"
    }
  }
}

响应字段说明

字段	类型	说明
status	string	操作状态
message	string	操作消息
data.token_id	integer	恢复的Token ID
data.restored_at	string	恢复时间
data.token_info	object	代理信息

---

批量恢复代理

批量恢复已删除的代理Token。

接口信息

项目	说明
接口地址	https://api.ipflex.ink/token/batch/restore
请求方法	PUT
认证方式	Bearer Token（从后台获取）
Content-Type	application/json

请求参数

参数名	类型	必填	说明	示例
token_ids	array	是	Token ID列表	[12345, 12346]

请求示例

cURL

curl -H "Authorization: Bearer YOUR_TOKEN" \
  -X PUT \
  -H "Content-Type: application/json" \
  -d '{
    "token_ids": [12345, 12346]
  }' \
  https://api.ipflex.ink/token/batch/restore

Python

import requests

headers = {'Authorization': 'Bearer YOUR_TOKEN'}

response = requests.put(
    'https://api.ipflex.ink/token/batch/restore',
    headers=headers,
    json={
        'token_ids': [12345, 12346]
    }
)

print(response.json())

响应示例

{
  "status": "success",
  "message": "批量恢复完成",
  "data": {
    "total_count": 2,
    "success_count": 2,
    "failed_count": 0,
    "failed_ids": [],
    "restored_at": "2024-01-08T12:30:00Z"
  }
}

---

---

相关文档

• 生成代理 - 创建新代理
• 测试代理 - 测试代理状态
• API认证 - 认证方式详解