静觅 崔庆才的个人站点 - Python爬虫教程

0%

删除 AceDataCloud 平台 API 凭证

作者 发表于 分类于 阅读次数： 本文字数： 1.6k 阅读时长 ≈ 1 分钟

永久删除一枚 API 凭证。删除后立即不可恢复，所有正在使用该 Token 的业务接口会马上收到 401。

ℹ️ 本接口属于 AceDataCloud 平台管理 API，统一前缀 https://platform.acedata.cloud/api/v1/。

接口概览

项 内容
方法 DELETE
URL https://platform.acedata.cloud/api/v1/credentials/{credential_id}
鉴权 ✅ 需要账户令牌

⚠️ URL 不要带尾部斜杠——/credentials/{id} 不是 /credentials/{id}/。

鉴权说明（如何获取账户令牌）

请求头：

1
 
Authorization: Bearer platform-v1-92eb****629c

获取方式见管理 AceDataCloud 平台账户令牌。

路径参数

参数 类型 必填 说明
credential_id UUID ✅ 要删除的凭证 ID

请求示例

cURL

1
2
 
curl -X DELETE 'https://platform.acedata.cloud/api/v1/credentials/df3e1b1b-9e72-4c4f-9a83-1e23f7c8b4d6' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

Python

1
2
3
4
5
6
7
8
9
10
 
import requests

cred_id = "df3e1b1b-9e72-4c4f-9a83-1e23f7c8b4d6"
resp = requests.delete(
    f"https://platform.acedata.cloud/api/v1/credentials/{cred_id}",
    headers={"authorization": "Bearer platform-v1-92eb****629c"},
    timeout=10,
)
assert resp.status_code == 204, resp.text
print("✅ 已删除")

Node.js

1
2
3
4
5
6
 
const credId = 'df3e1b1b-9e72-4c4f-9a83-1e23f7c8b4d6'
const r = await fetch(`https://platform.acedata.cloud/api/v1/credentials/${credId}`, {
  method: 'DELETE',
  headers: { authorization: 'Bearer platform-v1-92eb****629c' },
})
console.log('status:', r.status) // 204

响应

  • 成功：HTTP 204 No Content，无响应体。
  • 失败：返回错误 JSON，见下表。

错误处理

HTTP code 含义
401 not_authenticated 缺少账户令牌
403 permission_denied 该凭证不属于你
404 not_found 凭证不存在或已被删除
500 — URL 末尾误加斜杠，去掉后重试

实用提示

  • 删除不可逆——平台不保留 Token 副本。如果你只是怀疑泄露还想保留监控数据，应使用轮换 AceDataCloud 平台 API 凭证而不是删除。
  • 删除不会退还该凭证已消耗的额度。Application 余额按消耗实时扣减，删除凭证不影响余额账面。
  • credentials_count 字段实时更新：通过获取 AceDataCloud 平台服务申请详情 可看到该 Application 当前已发凭证数。
  • 批量清理僵尸凭证：先调列表接口 找出 used_at IS NULL 或 used_at 距今 > 90 天的，逐个调用本接口删除。

相关接口

相关文章