易储 API 使用说明

使用说明与 API 文档

核心功能

• 统一 API 地址 https://api.pc530.com/v1/storage，URL 中不含邮箱或用户名
• 标准 Authorization: Bearer 鉴权，遵循 RFC 6648
• 支持 Set / Get / Delete 三种 RESTful 操作
• 可选 expire_in 相对过期，或永久保存
• Key 数量按会员等级限额（见下方容量说明），API 限流 10 QPS

技术文档

安全鉴权

在调用任何接口前，请先前往控制台获取您的 API Secret。所有用户共用固定 API 根地址，身份仅通过 HTTP Header 识别：

Authorization: Bearer 您的唯一API_SECRET
Content-Type: application/json

API 根地址：https://api.pc530.com/v1/storage

代码示例

Python 调用示例：存储/更新数据

import requests

url = "https://api.pc530.com/v1/storage/set"
headers = {
    "Authorization": "Bearer 您的唯一API_SECRET",
    "Content-Type": "application/json"
}
data = {
    "key": "site_notice",
    "value": "欢迎来到PC530网站！今日维护升级调整。",
    "expire_in": 3600  # 3600秒(1小时)后自动销毁。如果传0则为永久保存。
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

cURL 示例：快速读取数据

curl -X GET "https://api.pc530.com/v1/storage/get?key=site_notice" \
  -H "Authorization: Bearer 您的唯一API_SECRET"

GET 返回数据结构

成功时 HTTP 状态码 200，响应体为 JSON：

{
  "code": 200,
  "message": "success",
  "data": {
    "key": "site_notice",
    "value": "欢迎来到PC530网站！今日维护升级调整。",
    "expired_at": 946656000,
    "updated_at": 1749109800
  }
}

data 字段说明：

• key（String）：请求的键名
• value（String）：存储的文本内容
• expired_at（Integer）：绝对过期 Unix 时间戳（秒）；永久有效固定为 946656000（即 2000-01-01 00:00:00 东八区）
• updated_at（Integer）：上次写入或更新的 Unix 时间戳（秒）

若 key 不存在或已过期，HTTP 状态码 404：

{
  "code": 404,
  "message": "key 不存在或已过期"
}

未携带或 Secret 错误时，HTTP 状态码 401：

{
  "code": 401,
  "message": "Unauthorized"
}

cURL 示例：物理删除

curl -X DELETE "https://api.pc530.com/v1/storage/delete" \
  -H "Authorization: Bearer 您的唯一API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"key": "site_notice"}'

警告：删除为即时物理删除，系统不保留备份，请谨慎操作。

容量额度（按会员等级）

• 普通会员：最多 100 个 Key
• VIP会员：最多 10000 个 Key
• 超级VIP会员：最多 1000000 个 Key

注意事项

1. 频率限制：单用户 API 最大 10 QPS，超出返回 429。
2. 容量额度：按当前会员等级计算上限，请及时清理或设置合理过期时间。
3. 密钥保管：API Secret 为数据最高通行证，请勿在前端代码明文暴露；泄露请立即重置密钥。