接口定义中英文对照表：压缩备份开发常用术语速查
做压缩备份相关的开发或对接时，经常要和各种接口打交道。尤其是团队里有国外成员，或者使用开源项目文档时，中英文术语混杂，容易搞混。下面整理了一份实用的接口定义中英文对照表，专为压缩备份场景准备，方便查阅。
基础概念
Compression - 压缩
Decompression - 解压
Backup - 备份
Restore - 恢复
Archive - 归档文件
Data Integrity - 数据完整性
Checksum - 校验和
Encryption - 加密
Decryption - 解密
Compression Ratio - 压缩率常见接口参数
source_path - 源路径
target_path - 目标路径
compression_level - 压缩级别（1-9）
algorithm - 压缩算法（如 gzip, zip, tar）
encrypt_key - 加密密钥
split_size - 分卷大小
overwrite - 是否覆盖
include_hidden - 是否包含隐藏文件
exclude_list - 排除列表
timestamp - 时间戳HTTP 接口常用字段（RESTful 风格）
POST /api/v1/backup - 创建备份任务
GET /api/v1/backup/{id} - 查询备份状态
PUT /api/v1/backup/{id}/pause - 暂停备份
DELETE /api/v1/backup/{id} - 删除备份记录
POST /api/v1/restore - 触发恢复操作
status: "running", "completed", "failed" - 任务状态
progress: 0.75 - 进度（浮点数）
error_message - 错误信息（如有）实际应用场景举例
比如你在写一个定时备份脚本，调用的是某个云服务的 API。请求体里要传：
{
"source_path": "/data/logs",
"target_path": "s3://my-backup-bucket/logs",
"compression_level": 6,
"algorithm": "gzip",
"encrypt_key": "your-key-here",
"split_size": "100MB"
}这时候如果文档是英文的，看到 compression_level 就知道对应“压缩级别”，不会误填成字符串或其他格式。
再比如前端展示备份任务列表，接口返回 status: "failed"，你就明白这条任务失败了，需要提示用户检查日志。
小技巧：命名统一很重要
团队协作时，建议在项目初期就定好术语规范。比如统一用 backup_id 而不是 bkp_id 或 backupId，减少沟通成本。前后端都按这个对照表来，接口文档也清晰，联调少踩坑。