错误处理
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": "发生内部错误,请稍后重试或联系支持。"
}