Make admin and API errors visible and traceable

Return structured JSON errors with request IDs, log unexpected exceptions with tracebacks, and show HTTP and network failures in the admin UI without losing unsaved source.

Preserve publication errors when release listing also fails, handle cancelled preview promises, and add regression tests, browser failure scenarios, and updated API documentation.
This commit is contained in:
2026-11-13 09:55:55 +03:00
parent 88ac95dd19
commit 231490bb7c
19 changed files with 1714 additions and 67 deletions
+52 -5
View File
@@ -5,11 +5,21 @@ from contextlib import asynccontextmanager
import httpx
from ..error_handling import error_headers, log, request_id
class ApiError(Exception):
def __init__(self, status: int, data: dict):
self.status, self.data = status, data
super().__init__(data.get("error", {}).get("message", "Ошибка API"))
self.status = status
detail = {"code": "api_error", "message": "Ошибка API", "request_id": request_id()}
detail.update(data.get("error", {}))
self.data = {**data, "error": detail}
super().__init__(detail["message"])
def annotate(self, result):
result.headers.update(error_headers(self.data["error"]))
result.headers["X-Admin-Error"] = "1"
return result
class AdminApi:
@@ -17,10 +27,47 @@ class AdminApi:
self.client = client
async def call(self, method, path, data=None):
response = await self.client.request(method, "/admin/api/v1" + path, json=data)
try:
response = await self.client.request(method, "/admin/api/v1" + path, json=data)
except httpx.RequestError:
log.exception(
"api_unavailable request_id=%s method=%s path=%s", request_id(), method, path
)
raise ApiError(
503,
{
"error": {
"code": "api_unavailable",
"message": "API недоступен. Проверьте текущую версию перед повтором.",
}
},
) from None
try:
payload = response.json()
if response.status_code >= 400:
detail = payload["error"]
if not isinstance(detail["code"], str) or not isinstance(detail["message"], str):
raise ValueError("Invalid API error contract")
except (ValueError, KeyError, TypeError):
log.exception(
"invalid_api_response request_id=%s method=%s path=%s status=%s",
request_id(),
method,
path,
response.status_code,
)
raise ApiError(
502,
{
"error": {
"code": "invalid_api_response",
"message": "API вернул некорректный ответ. Проверьте текущую версию перед повтором.",
}
},
) from None
if response.status_code >= 400:
raise ApiError(response.status_code, response.json())
return response.json()
raise ApiError(response.status_code, payload)
return payload
@asynccontextmanager