3 API3.7
Stanje usluge: GET /health
Stanje usluge, a s ključem i stanje njezinih dijelova i kanala slanja.
- U sandboxu
Jednostavnim riječima
Ovaj poziv kaže radi li usluga. S ključem kaže i kako rade njezina baza podataka, datoteke s pravilima, red čekanja i kanali slanja.
GET /health odgovara 200 sa status postavljenim na ok ili degraded, ili 503 s down kad baza podataka ne odgovara. Bez ključa odgovor sadrži samo status. To je jedini poziv za koji nije potreban ključ.
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 ključem
Ključ dodaje checks:
| Provjera | Značenje |
|---|---|
database | Odgovara li baza podataka. |
validation_artefacts | Jesu li zakačene datoteke s pravilima provjere prisutne i aktualne. |
queue | Stanje reda zadataka. |
routes | Jedan unos po kanalu slanja, sa status, nizom viđenih pogrešaka i spremljenim aktivnim pristupnim podacima za taj kanal. |
status kanala slanja je ok, degraded, unreachable ili no_rail. DE-XRECHNUNG nema prijenosni sustav i prikazuje no_rail. Ništa ne ispituje prijenosni sustav: status proizlazi iz pogrešaka koje je radnik vidio. Kanal na koji nitko nije slao prikazuje ok, a pet pogrešaka zaredom prikazuje unreachable. Kanal nikad ne mijenja vlastiti status usluge; prekid rada prijenosnog sustava prijavljuje nam se kao upozorenje.
Napomena
Sandbox
Iza ok još ne stoji provjera dostupnosti, pa ga koristite kao provjeru da usluga radi, a ne kao obećanje. Dana 7. okt. 2026. hostirani sandbox još je radio na izdanju prije ugovora 0.19.3, pa njegov odgovor bez ključa i dalje navodi pet kanala slanja, sve not_configured, kao u primjeru gore. Ugovor 0.19.3 i referenca opisuju odgovor samo sa status.