3 API3.7
Stato del servizio: GET /health
Lo stato del servizio e, con una chiave, lo stato delle sue parti e dei canali.
- Nella sandbox
In parole semplici
Questa chiamata dice se il servizio è attivo. Con una chiave dice anche come stanno il database, i file delle regole, la coda e i canali.
GET /health risponde 200 con status impostato a ok o degraded, oppure 503 con down quando il database non risponde. Senza chiave la risposta contiene solo status. È l’unica chiamata che non richiede una chiave.
curl "https://api-sandbox-eu.eurinvoice.com/health"import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Example {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api-sandbox-eu.eurinvoice.com/health"))
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}const response = await fetch('https://api-sandbox-eu.eurinvoice.com/health', {
});
console.log(response.status);
console.log(await response.text());{
"routes": {
"FR-PA": "not_configured",
"DE-XRECHNUNG": "not_configured",
"PEPPOL": "not_configured",
"RO-EFACTURA": "not_configured",
"PL-KSEF": "not_configured"
},
"status": "ok"
}Con una chiave
Una chiave aggiunge checks:
| Controllo | Significato |
|---|---|
database | Se il database risponde. |
validation_artefacts | Se i file delle regole di validazione fissate sono presenti e recenti. |
queue | Lo stato della coda di lavoro. |
routes | Una voce per canale, con uno status, la serie di errori rilevati e le credenziali attive memorizzate per il canale. |
Lo status di un canale è ok, degraded, unreachable o no_rail. DE-XRECHNUNG non ha un’infrastruttura di trasmissione e riporta no_rail. Nessuno interroga un’infrastruttura: lo stato deriva dagli errori che il worker ha visto. Un canale su cui nessuno ha ancora inviato riporta ok, e cinque errori consecutivi riportano unreachable. Un canale non modifica mai lo status del servizio; l’interruzione di un’infrastruttura ci viene segnalata come allarme.
Nota
Sandbox
Dietro ok non c’è ancora alcun controllo di disponibilità, quindi va usato come verifica che il servizio sia attivo e non come una promessa. Il 7 ott. 2026 la sandbox ospitata eseguiva ancora la versione precedente al contratto 0.19.3, quindi la sua risposta senza chiave elenca ancora i cinque canali, tutti not_configured, come nell’esempio sopra. Il contratto 0.19.3 e il riferimento descrivono la risposta con il solo status.