Localizzazione

L'API Invoicetronic supporta la localizzazione dei messaggi di errore e validazione tramite l'header HTTP standard Accept-Language (RFC 7231). Questo consente alla tua integrazione di ricevere messaggi nella lingua preferita, migliorando l'esperienza degli utenti finali.

Lingue supportate

Le lingue attualmente supportate sono:

Italiano (it) - Lingua predefinita
Inglese (en)
Tedesco (de)

Utilizzo

Per richiedere i messaggi di errore in una lingua specifica, includi l'header Accept-Language nelle tue richieste HTTP:

curl -X POST https://api.invoicetronic.com/v1/company/ \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Accept-Language: en" \
  -H "Content-Type: application/json" \
  -d '{"vat": null}'

Comportamento predefinito

Se l'header Accept-Language non è presente o contiene una lingua non supportata, l'API risponderà in italiano (lingua predefinita).

Esempi

Richiedere messaggi in inglese

POST /v1/company/ HTTP/1.1
Host: api.invoicetronic.com
Authorization: Basic YOUR_API_KEY
Accept-Language: en
Content-Type: application/json

{"vat": null}

Eventuali errori di validazione saranno restituiti in inglese:

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "Bad Request",
  "status": 400,
  "detail": "vat is required"
}

Richiedere messaggi in italiano

POST /v1/company/ HTTP/1.1
Host: api.invoicetronic.com
Authorization: Basic YOUR_API_KEY
Accept-Language: it
Content-Type: application/json

{"vat": null}

Eventuali errori di validazione saranno restituiti in italiano:

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "Bad Request",
  "status": 400,
  "detail": "vat è obbligatorio"
}

Richiedere messaggi in tedesco

POST /v1/company/ HTTP/1.1
Host: api.invoicetronic.com
Authorization: Basic YOUR_API_KEY
Accept-Language: de
Content-Type: application/json

{"vat": null}

Eventuali errori di validazione saranno restituiti in tedesco:

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "Bad Request",
  "status": 400,
  "detail": "vat ist erforderlich"
}

Valori di qualità (Quality Values)

L'API supporta i valori di qualità (q-values) secondo RFC 7231. Puoi specificare più lingue in ordine di preferenza:

Accept-Language: en;q=0.9, it;q=0.8

L'API selezionerà la prima lingua supportata dalla lista in base ai valori di qualità.

Varianti regionali

L'API accetta varianti regionali come it-IT, en-US o de-DE, ma considera solo il codice lingua primario (it, en o de):

Accept-Language: en-US  # Trattato come 'en'
Accept-Language: it-IT  # Trattato come 'it'
Accept-Language: de-DE  # Trattato come 'de'
Accept-Language: de-AT  # Trattato come 'de' (Austria)
Accept-Language: de-CH  # Trattato come 'de' (Svizzera)

Note importanti

Lingua predefinita

A partire dalla versione 1.0.20, la lingua predefinita è italiano. Nelle versioni precedenti la lingua predefinita era inglese. Se la tua integrazione si aspetta messaggi in inglese, assicurati di includere sempre l'header Accept-Language: en nelle richieste.

Validazione preventiva

Quando utilizzi gli endpoint di validazione preventiva, i messaggi di errore di validazione rispetteranno la lingua specificata nell'header Accept-Language.

RFC 7231

L'implementazione segue la specifica HTTP standard RFC 7231 sezione 5.3.5 per l'header Accept-Language.

Migrazione da Invoicetronic-Language

Nelle versioni precedenti, l'API utilizzava un header personalizzato Invoicetronic-Language. Questo header è stato deprecato e non è più supportato. Se la tua integrazione lo utilizza ancora, aggiornala per usare Accept-Language:

Vecchio header	Nuovo header
`Invoicetronic-Language: en`	`Accept-Language: en`
`Invoicetronic-Language: it`	`Accept-Language: it`
`Invoicetronic-Language: de`	`Accept-Language: de`

L'uso dell'header standard Accept-Language garantisce una migliore compatibilità con gli strumenti HTTP esistenti e segue le best practice del web.