用途:诊断并修复 Lokalise API 的常见错误与异常,适用于遇到 Lokalise 报错、调试失败请求或排查集成问题时。
主要能力:所有 Lokalise API 错误返回统一 JSON 结构,含 error.message 与 error.code(与 HTTP 状态码一致);Node SDK 会以异常抛出,带 error.code、error.message、error.headers。技能按状态码给出成因与修复:401 令牌无效或缺失(检查 X-Api-Token、去除空白、在 https://app.lokalise.com/profile#apitokens 重新生成);400 参数校验失败(project_id 格式、必填字段、语言 ISO 码、键名长度、platform 取值);404 资源不存在或令牌无权限;429 触发限流(每秒 6 次,遵循 Retry-After);413 请求体过大(文件超 50 MB 或批量超 500 项);500/503 为 Lokalise 侧问题,建议等待 30 秒后重试最多 3 次。
使用方式:需 curl、@lokalise/node-api SDK、环境变量 LOKALISE_API_TOKEN,jq 可选。可用 curl 验证令牌:curl -s -o /dev/null -w "%{http_code}" -H "X-Api-Token: ${LOKALISE_API_TOKEN}" "https://api.lokalise.com/api2/teams",期望 200。可运行诊断脚本依次检查令牌、项目访问、限流状态与键数量;也可用 lokaliseCall 封装 SDK 调用,按错误码输出可操作提示。
适用场景与限制:适合排查 Lokalise 集成报错与构建健壮的错误处理。限流重试细节见 lokalise-rate-limits,翻译数据问题见 lokalise-data-handling。资料未提供价格、平台支持范围等其它信息。