Statistiken abrufen

Die Zahlen, die das Dashboard in den Ansichten Dashboard und Challenges darstellt, stammen aus der API des Dashboards. Über dieselben Endpunkte rufen Sie die Werte für eigene Auswertungen ab.

Die Basis-URL lautet:

https://api-app.eu-captcha.eu/myra-auto-app-api

Alle Aufrufe verwenden die Methode GET und benötigen einen Token nach JSON Web Token in der Kopfzeile Authorization. Siehe Sitekeys verwalten.

Warning

Diese Schnittstelle bedient das Dashboard und ist nicht Teil der Version 1.1 der öffentlichen API. Sie besitzt keine Zusicherung zur Stabilität und keine abrufbare Beschreibung im Browser.

Endpunkte

Die folgenden Endpunkte stehen zur Verfügung:

Endpunkt	Inhalt
/captcha-stats-user	Aktionen über alle Sitekeys, auf die Sie Zugriff haben.
/captcha-stats-sitekey	Aktionen eines einzelnen Sitekeys.
/captcha-challenges-per-user	Anzahl der Challenges über alle zugänglichen Sitekeys.
/recent-captcha-challenges-for-sitekey	Die jüngsten Challenges eines Sitekeys als Liste.
/captcha-difficulty-distribution	Verteilung der Schwierigkeitsgrade eines Sitekeys.
/captcha-threats-blocked	Anzahl der abgewehrten Zugriffe eines Sitekeys.

Ein Sitekey, auf den Sie keinen Zugriff haben, liefert die Antwort {"success": false}. Dasselbe gilt, wenn der Parameter sitekey fehlt, sofern der Endpunkt ihn benötigt.

Zeitraum wählen

Die Endpunkte zu den Aktionen und den Challenges verwenden dieselben Parameter für den Zeitraum:

Parameter	Vorgabe	Beschreibung
sitekey	leer	UUID des Sitekeys. Bleibt der Wert leer, gelten alle zugänglichen Sitekeys.
max_days	5	Länge des Zeitraums in Tagen.
start_date	leer	Erster Tag des Zeitraums im Format JJJJ-MM-TT. Ohne Angabe endet der Zeitraum am heutigen Tag.
per_day	0	Mit per_day=1 liefert /captcha-stats-user die Werte je Tag statt als Summe.

curl "https://api-app.eu-captcha.eu/myra-auto-app-api/captcha-stats-user?max_days=30&per_day=1" \
  -H "Authorization: Bearer <Token>"

Die Antwort enthält je Zeile die Art der Aktion, die Anzahl und — bei per_day=1 — das Datum:

[
  { "action_type": "ACC", "date_at": "2026-08-01", "count": 1284 },
  { "action_type": "BIT", "date_at": "2026-08-01", "count": 37 }
]

Arten von Aktionen

Das Feld action_type unterscheidet die folgenden Werte:

Wert	Bedeutung
VFC	Eine Challenge wurde ausgeliefert.
ASC	Eine Challenge wurde gelöst.
VSC	Der Client hat die Challenge ohne Erfolg gemeldet. Der Wert gilt als neutral, nicht als Blockierung.
ACC	Die Prüfung des Tokens war erfolgreich, der Zugriff ist zugelassen.
BCI	Der Nachweis zur Challenge war falsch.
BIC	Der Client hat eine andere Challenge eingereicht, als ihm zugewiesen war.
BCR	Der Token war bereits verwendet oder abgelaufen.
BIT	Die Anfrage enthielt keinen auswertbaren Token.

Alle Werte, die mit B beginnen, sind blockierte Zugriffe.

Das Dashboard fasst die Werte wie folgt zusammen:

Kennzahl	Enthaltene Aktionen
Verified	alle Aktionen ACC
Blocked	alle Aktionen, deren Wert mit B beginnt
Challenges solved	die Aktionen ASC und VSC
Block rate	Anteil der blockierten Zugriffe an der Summe aus blockierten und zugelassenen Zugriffen, in Prozent

Siehe Dashboard.

Jüngste Challenges

GET /recent-captcha-challenges-for-sitekey

Der Endpunkt verwendet die folgenden Parameter:

Parameter	Vorgabe	Beschreibung
sitekey	—	UUID des Sitekeys. Der Parameter ist erforderlich.
max_results	30	Anzahl der Einträge je Seite.
page	0	Seite der Ergebnisliste.

Die Antwort enthält die Einträge im Feld member, die Gesamtzahl im Feld totalItems sowie die Domain und die Bezeichnung des Sitekeys.

Das Feld created_ai_result nennt die Einschätzung der Anfrage. Es besitzt die Werte browser, bot und unknown. Siehe Challenges.

Verteilung der Schwierigkeit

GET /captcha-difficulty-distribution

Der Endpunkt verwendet die folgenden Parameter:

Parameter	Vorgabe	Beschreibung
sitekey	—	UUID des Sitekeys. Der Parameter ist erforderlich.
days	1	Zeitraum in Tagen, 1 bis 7. Werte darüber gelten als 7.

Die Antwort nennt je Schwierigkeitsgrad die Anzahl der Challenges. Die Grade der Anzeige reichen weiter als der Startwert eines Sitekeys, denn das Myra EU CAPTCHA erhöht die Schwierigkeit bei Verdacht selbsttätig. Siehe Sitekey konfigurieren.

Abgewehrte Zugriffe

GET /captcha-threats-blocked

Der Endpunkt verwendet dieselben Parameter wie die Verteilung der Schwierigkeit und antwortet mit einer einzelnen Zahl:

{ "count": 214 }