Stats

Infrastrukturgesundheit einer Engine oder eines Endpunkts in der letzten Stunde. Nicht auf Ihr Konto oder Ihren Tenant begrenzt.

Der Stats-Endpunkt liefert eine Infrastruktur-Gesundheitsaufnahme für eine API-Engine oder einen konkreten Pfad. Die Kennzahlen werden plattformweit über ein Stundenfenster aggregiert. Sie sind nicht Ihre Konto- oder Tenant-Nutzung. Es gibt keine Zeitreihe. Nutzen Sie Nutzung für Ihr Kontokontingent.

Dieser Endpunkt ist kostenlos. Er verbraucht niemals Credits.

Das sind Infrastruktur-Stats der Plattform, nicht Stats Ihres Kontos oder Tenants. Jeder authentifizierte Aufrufer sieht dieselbe Aufnahme. Für verbleibende Credits und Ratenlimits nutzen Sie Nutzung.

Abfrageparameter

Geben Sie mindestens engine oder path an.

engine (string): API-Familie zum Prüfen, zum Beispiel linkedin oder google.
path (string): konkreter Endpunkt zum Prüfen, zum Beispiel /v1/linkedin/profile-info. Wenn Sie auch engine übergeben, verwenden Sie einen Endpunkt dieser API.

Anfrage

curl "https://api.huntapi.com/v1/stats?engine=linkedin" \
  -H "x-api-key: YOUR_API_KEY"

curl "https://api.huntapi.com/v1/stats?path=/v1/linkedin/profile-info" \
  -H "x-api-key: YOUR_API_KEY"

Gesundheitswerte

operational: Erfolgsrate von mindestens 99 %.
degraded: Erfolgsrate von 90 % bis 99 %.
down: Erfolgsrate unter 90 %.

Antwortfelder

Feld	Typ	Beschreibung
`engine`	`string`	Engine-Slug aus dem Katalog (zum Beispiel `linkedin`)
`path`	`string \| null`	Normalisierter Pfadfilter, oder `null` bei reiner Engine-Abfrage
`health`	`string`	`operational`, `degraded` oder `down` für die letzte Stunde
`success_rate`	`number`	Erfolgsrate der letzten Stunde. Nur HTTP 5xx gelten als Fehler. Fenster mit geringem Volumen werden geglättet.
`avg_response_time_ms`	`integer`	Durchschnittliche Antwortzeit in Millisekunden. Dauern über 60 Sekunden werden ausgeschlossen.
`window`	`string`	Aggregationsfenster. Immer `1h`.

Die Antwort enthält weder Anfragevolumen noch rohe Fehlerzahlen noch Daten auf Konto- oder Tenant-Ebene.

Beispielantwort

{
  "engine": "linkedin",
  "path": "/v1/linkedin/profile-info",
  "health": "operational",
  "success_rate": 99.412,
  "avg_response_time_ms": 840,
  "window": "1h"
}

Fehler

Code	Beschreibung
`400`	`engine` und `path` fehlen, ungültiger Wert, oder Pfad passt nicht zu `engine`
`401`	API-Schlüssel fehlt oder ist ungültig
`404`	Unbekannte Engine (nicht im API-Katalog)
`503`	Statusdaten vorübergehend nicht verfügbar

Siehe auch: Nutzung für Ihr Kontokontingent (Tenant-bezogen), Statuscodes für HTTP-Abrechnungsregeln und Fehlerbehandlung für Integrationsfehler.