# Что сервер пишет в WWW-Authenticate при 401: какую схему входа он ждёт. BASIC_CHALLENGE = 'Basic realm="messenger", charset="UTF-8"' # только POST /auth/sessions BEARER_CHALLENGE = 'Bearer realm="messenger"' # все остальные защищённые запросы class ApiError(Exception): def __init__(self, status_code: int, code: str, message: str, headers: dict | None = None): super().__init__(message) self.status_code = status_code self.code = code self.message = message self.headers = headers or {} def bad_request(message: str) -> ApiError: return ApiError(400, "invalid_request", message) def unauthorized(message: str = "Unauthorized", challenge: str = BEARER_CHALLENGE) -> ApiError: return ApiError(401, "unauthorized", message, {"WWW-Authenticate": challenge}) def not_found(message: str) -> ApiError: return ApiError(404, "not_found", message) def conflict(message: str) -> ApiError: return ApiError(409, "conflict", message) def unavailable(message: str = "Service temporarily unavailable") -> ApiError: return ApiError(503, "unavailable", message) def payload_too_large(message: str) -> ApiError: return ApiError(413, "payload_too_large", message) def unsupported_media_type(message: str) -> ApiError: return ApiError(415, "unsupported_media_type", message)