删除导出模板
按 (type, id) 删除一个导出模板。同步返回被删除的完整模板对象,方便调用方做本地审计或撤销时重新创建。
请求地址
POST {BASE_URL}/api/open/v1/export-templates/delete鉴权 Header
和 创建翻译任务 完全一样。POST 的 raw body 参与签名:MD5(timestamp + raw_body + appSecret)。
请求体(JSON)
json
{
"type": "project_strings",
"id": "tpl-9d3f1a2c"
}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | string | 是 | 模板类型:project_strings / task_strings |
id | string | 是 | 要删除的模板 ID |
响应
json
{
"success": true,
"code": 0,
"msg": "ok",
"trace_id": "...",
"data": {
"type": "project_strings",
"deleted": {
"id": "tpl-9d3f1a2c",
"name": "默认 INI 导出",
"is_default": true,
"format": "ini",
"mode": "single",
"languages": ["en", "ja", "ko"],
"field_order": [
{ "type": "language", "value": "en" },
{ "type": "language", "value": "ja" },
{ "type": "language", "value": "ko" }
],
"created_at": 1715520000000,
"updated_at": 1715606400000
}
}
}deleted 是删除前的完整模板对象(与 详情接口 同结构)。
行为说明
- 删除后不会自动把另一个模板提升为新的默认模板 —— 同
type下允许零个is_default=true。 - 并发命中两次"删同一个 id"的请求是安全的:第二个请求会得到 404(因为前一个已经把它删了)。
- 操作不可恢复 —— 如果误删,请用响应里的
deleted对象,调用 创建接口 重新创建(注意:新对象会得到一个新的id)。
错误码
| code | 说明 |
|---|---|
| 400 | 请求体不是合法 JSON / type 缺失或非法 / id 缺失 |
| 401 | 签名校验失败 / 时间戳过期 |
| 403 | App Secret 未配置 |
| 404 | 找不到指定 id 的模板(type 选错也会 404) |
| 500 | 写入失败或系统错误 |
示例
bash
APP_KEY="5685414646a54423c891d87194d87f3f"
APP_SECRET="<你的 App Secret>"
BASE_URL="https://api.loxily.com"
BODY='{"type":"project_strings","id":"tpl-9d3f1a2c"}'
TIMESTAMP=$(date +%s)
SIGN=$(printf '%s' "${TIMESTAMP}${BODY}${APP_SECRET}" | md5)
curl -s -X POST "${BASE_URL}/api/open/v1/export-templates/delete" \
-H "Content-Type: application/json" \
-H "X-Loxily-AppKey: ${APP_KEY}" \
-H "X-Loxily-Timestamp: ${TIMESTAMP}" \
-H "X-Loxily-Sign: ${SIGN}" \
--data "${BODY}"