3 API3.7
Starea serviciului: GET /health
Starea serviciului și, cu o cheie, starea componentelor și a canalelor sale.
- În sandbox
În cuvinte simple
Acest apel spune dacă serviciul funcționează. Cu o cheie, spune și cum stau baza de date, fișierele de reguli, coada și canalele.
GET /health răspunde 200 cu status setat pe ok sau degraded, sau 503 cu down atunci când baza de date nu răspunde. Fără cheie, răspunsul conține doar status. Este singurul apel care nu necesită cheie.
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"
}Cu o cheie
O cheie adaugă checks:
| Verificare | Semnificație |
|---|---|
database | Dacă baza de date răspunde. |
validation_artefacts | Dacă fișierele de reguli de validare fixate sunt prezente și recente. |
queue | Starea cozii de lucru. |
routes | Câte o intrare pentru fiecare canal, cu un status, seria de erori întâlnite și datele de autentificare active stocate pentru el. |
status-ul unui canal este ok, degraded, unreachable sau no_rail. DE-XRECHNUNG nu are rețea și apare ca no_rail. Nimic nu sondează o rețea: starea vine din erorile pe care le-a întâlnit procesul de lucru. Un canal către care nu a trimis nimeni apare ca ok, iar cinci erori la rând apar ca unreachable. Un canal nu schimbă niciodată status-ul serviciului în sine; o întrerupere a unei rețele ne este raportată ca alertă.
Notă
Sandbox
În spatele lui ok nu există încă nicio sondă de disponibilitate, așa că folosiți-l ca verificare de funcționare, nu ca promisiune. Pe 7 oct. 2026, sandbox-ul găzduit rula încă versiunea dinaintea contractului 0.19.3, așa că răspunsul lui fără cheie enumeră în continuare cele cinci canale, toate not_configured, ca în exemplul de mai sus. Contractul 0.19.3 și referința descriu răspunsul doar cu status.