Docs

3 API3.7

3.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"
Odpoveď200 OK
{
  "routes": {
    "FR-PA": "not_configured",
    "DE-XRECHNUNG": "not_configured",
    "PEPPOL": "not_configured",
    "RO-EFACTURA": "not_configured",
    "PL-KSEF": "not_configured"
  },
  "status": "ok"
}
Zaznamenané 7. okt. 2026.

S kľúčom

Kľúč pridá checks:

KontrolaVýznam
databaseČi databáza odpovedá.
validation_artefactsČi sú pripnuté súbory validačných pravidiel prítomné a aktuálne.
queueStav pracovného frontu.
routesJedna 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.

Na tejto stránke