# ADR-47 — L'API parla una sola lingua e risponde con codici - **Stato:** Accettata - **Area:** Interfacce, API e lingue - **Fonte di verità per:** la scelta di progetto descritta qui sotto; i requisiti (`PREFISSO-NN`) che la attuano stanno nei documenti di dominio, indicati nelle *Conseguenze*. ## Decisione **L'API parla una sola lingua e risponde con codici.** Ogni errore rivolto all'utente ha `detail = {code, message, params}`: `message` è in inglese per chi non usa la dashboard, `code` è ciò che il frontend traduce (`error.`), `params` porta i valori (gli importi come `*_sats`). Anche l'errore 500 generico ha questa forma (`internal_error`) e non espone il testo dell'eccezione. - *Conseguenze:* aggiungere un errore significa dargli un codice e aggiungere `error.` in tutte le 7 lingue (vedi [api.md](../api.md)). *Codice:* `app/api/errors.py:ApiError` · `app/api/errors.py:http_error` · `app/main.py:log_unhandled_exception` · *Test:* `tests/unit/test_rounds_route.py::test_unhandled_errors_use_the_structured_detail_shape`