Docs

3 API3.7

3.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"
Odgovor200 OK
{
  "routes": {
    "FR-PA": "not_configured",
    "DE-XRECHNUNG": "not_configured",
    "PEPPOL": "not_configured",
    "RO-EFACTURA": "not_configured",
    "PL-KSEF": "not_configured"
  },
  "status": "ok"
}
Zabilježeno 7. lis. 2026.

S ključem

Ključ dodaje checks:

ProvjeraZnačenje
databaseOdgovara li baza podataka.
validation_artefactsJesu li zakačene datoteke s pravilima provjere prisutne i aktualne.
queueStanje reda zadataka.
routesJedan 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.

Na ovoj stranici