查询术语列表

分页查询项目术语库。同步返回。

请求地址

GET {BASE_URL}/api/open/v1/terms

鉴权 Header

和 创建翻译任务 完全一样。GET 无 body 参与签名，签名算式退化为 MD5(timestamp + "" + appSecret)。

请求参数（Query）

参数	类型	必填	默认	说明
page	int	否	1	页码，从 1 开始
page_size	int	否	100	单页条数，上限 500
category	string	否	—	按分类精确匹配
keyword	string	否	—	对 content 字段做大小写不敏感的模糊匹配

源语言自动从项目配置解析，不需要传参；响应里会透出实际生效的 source_language。

响应

{
  "success": true,
  "code": 0,
  "msg": "ok",
  "trace_id": "...",
  "data": {
    "page": 1,
    "page_size": 100,
    "total": 357,
    "source_language": "zh-cn",
    "items": [
      {
        "id": "69e9b99c04e32e3f20afbbdb",
        "content": "战斗力",
        "source_language": "zh-cn",
        "category": "Item",
        "pic": "",
        "translations": {
          "en": "Combat Power",
          "ja": "戦闘力",
          "ko": "전투력"
        },
        "created_at": "2026-04-21T06:12:00.000Z",
        "updated_at": "2026-04-23T08:00:03.891Z"
      }
    ]
  }
}

• source_language：实际使用的源语言过滤（项目配置解析而来）
• items[].id：术语行 id，可直接用于 /terms/update / /terms/delete
• items[].translations：仅包含非空值；空串 / null 的语言会被过滤掉
• 默认排序：updated_at 降序，同时间按 id 降序（幂等分页）

错误码

code	说明
401	签名校验失败 / 时间戳过期
403	App Secret 未配置
404	appKey 无效
422	项目未配置源语言
500	系统错误

示例

APP_KEY="5685414646a54423c891d87194d87f3f"
APP_SECRET="<你的 App Secret>"
BASE_URL="https://api.loxily.com"

TIMESTAMP=$(date +%s)
SIGN=$(printf '%s' "${TIMESTAMP}${APP_SECRET}" | md5)

curl -s -G "${BASE_URL}/api/open/v1/terms" \
  --data-urlencode "page=1" \
  --data-urlencode "page_size=200" \
  --data-urlencode "category=Item" \
  --data-urlencode "keyword=战斗" \
  -H "X-Loxily-AppKey: ${APP_KEY}" \
  -H "X-Loxily-Timestamp: ${TIMESTAMP}" \
  -H "X-Loxily-Sign: ${SIGN}"