错误处理

flu.lu 的 API 使用标准 HTTP 状态码和应用错误消息来指示请求的成功或失败。

应用错误响应结构

当发生特定应用错误时,响应体将包含有助于理解问题的详细信息:

{
  "error_code": "unique_code",
  "message": "详细的错误信息"
}

常见应用错误示例

缺少参数

{
  "error_code": "missing_parameter",
  "message": "请求中缺少必需的 'url' 参数。"
}

无效的短码

{
  "error_code": "invalid_shortcode",
  "message": "指定的短码无效或不存在。"
}

链接已存在

{
  "error_code": "link_already_exists",
  "message": "您尝试创建的链接已存在。"
}

已达配额上限

{
  "error_code": "quota_reached",
  "message": "您已达到当前套餐允许的短链接数量上限。"
}

通用内部错误

{
  "error_code": "internal_error",
  "message": "发生内部错误,请稍后重试或联系支持。"
}