Error Handling

​

Error Response Format

{
  "error": "Error message description"
}

​

Status Codes

​

Common Error Scenarios

​

Validation Errors (400)

{
  "error": "Password must be at least 8 characters"
}

• Invalid email format
• Password too short
• Missing required fields
• Invalid data types

​

Authentication Errors (401)

{
  "error": "Invalid credentials"
}

• Wrong email/password
• Expired token
• Invalid 2FA code
• Missing Authorization header

​

Rate Limit Errors (403)

{
  "error": "Rate limit exceeded"
}

• Too many requests in short time
• Bot detection triggered
• Shield protection activated

​

Not Found Errors (404)

{
  "error": "User not found"
}

• Invalid user ID
• Resource deleted
• Invalid endpoint path

​

Error Handling Best Practices

try {
  const response = await fetch('/api/auth/login', {
    method: 'POST',
    body: JSON.stringify({ email, password })
  });
  
  if (!response.ok) {
    const error = await response.json();
    // Handle specific error types
    if (response.status === 401) {
      // Invalid credentials
    } else if (response.status === 403) {
      // Rate limited
    } else if (response.status === 400) {
      // Validation error
    }
    throw new Error(error.error);
  }
  
  const data = await response.json();
} catch (error) {
  // Handle network or parsing errors
}

​

Internal Error Logging

• Warn: Validation errors, failed auth attempts
• Error: Server errors, unexpected exceptions
• Info: Successful operations, important events