3 API3.7
Stav služby: GET /health
Stav služby a s kľúčom stav jej súčastí a kanálov.
- V sandboxe
Jednoducho povedané
Toto volanie oznámi, či služba beží. S kľúčom oznámi aj to, ako sa darí jej databáze, súborom pravidiel, fronte a kanálom.
GET /health odpovie 200 so status nastaveným na ok alebo degraded, alebo 503 s hodnotou down, keď databáza neodpovedá. Bez kľúča obsahuje odpoveď iba status. Je to jediné volanie, ktoré kľúč nevyžaduje.
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"
}S kľúčom
Kľúč pridá checks:
| Kontrola | Význam |
|---|---|
database | Či databáza odpovedá. |
validation_artefacts | Či sú pripnuté súbory validačných pravidiel prítomné a aktuálne. |
queue | Stav pracovného frontu. |
routes | Jedna položka pre každý kanál so status, radom zaznamenaných chýb a živými prístupovými údajmi uloženými pre kanál. |
status kanála je ok, degraded, unreachable alebo no_rail. DE-XRECHNUNG nemá sieť a hlási no_rail. Nič sieť nesonduje: stav vychádza z chýb, ktoré worker videl. Kanál, do ktorého nikto neposlal, hlási ok a päť chýb po sebe hlási unreachable. Kanál nikdy nemení vlastný status služby; výpadok siete sa nám hlási ako upozornenie.
Poznámka
Sandbox
Za hodnotou ok zatiaľ nestojí žiadna sonda dostupnosti, preto ju používajte ako kontrolu, že služba beží, nie ako sľub. Dňa 7. okt. 2026 hostovaný sandbox stále bežal na vydaní pred kontraktom 0.19.3, preto jeho odpoveď bez kľúča stále uvádza päť kanálov, všetky not_configured, ako v príklade vyššie. Kontrakt 0.19.3 a referenčná dokumentácia popisujú odpoveď len so status.