Zurück zum Hilfecenter

Schnittstelle: Rezepte

Rezept: Kennzahlen nach Power BI oder Excel holen

Kennzahlenreihen abrufen und als Tabelle für Auswertungen bereitstellen.

Für wen

Controlling, HSE-Leitung und IT.

Voraussetzungen

Schlüssel mit `metrics:read`

Schritt für Schritt

  1. 1

    Reihe abrufen

    Kennzahlen liegen als Tageswerte vor. Mit `metric` und `since` holen Sie eine einzelne Reihe.

    curl
    curl -sS "https://api.elyph.io/v1/metrics?metric=actions_overdue&since=2026-01-01&limit=200" \
  -H "Authorization: Bearer $ELYPH_API_KEY"
  2. 2

    In Power BI einbinden

    Power Query holt die Daten direkt; der Schlüssel wird in den Datenquelleneinstellungen als Kopfzeile hinterlegt.

    Power Query (M)
    let
    Quelle = Json.Document(Web.Contents(
        "https://api.elyph.io/v1/metrics",
        [
            Query = [ metric = "actions_overdue", since = "2026-01-01", limit = "200" ],
            Headers = [ Authorization = "Bearer " & ElyphApiKey ]
        ]
    )),
    Daten = Quelle[data],
    Tabelle = Table.FromRecords(Daten),
    Typen = Table.TransformColumnTypes(Tabelle, {{"captured_on", type date}, {"value", type number}})
in
    Typen
  3. 3

    Als CSV für Excel ablegen

    Ein kurzes Skript schreibt die Reihe als CSV in einen Ordner, den Excel regelmäßig aktualisiert.

    Python
    import os, csv, requests

key = os.environ["ELYPH_API_KEY"]
rows = requests.get(
    "https://api.elyph.io/v1/metrics",
    headers={"Authorization": f"Bearer {key}"},
    params={"metric": "actions_overdue", "since": "2026-01-01", "limit": 200},
    timeout=30,
).json()["data"]

with open("kennzahlen.csv", "w", newline="", encoding="utf-8") as file:
    writer = csv.DictWriter(file, fieldnames=["captured_on", "metric", "value"])
    writer.writeheader()
    for row in rows:
        writer.writerow({k: row[k] for k in writer.fieldnames})
  4. 4

    Berechnung dokumentieren

    Jeder Wert bringt das Feld `calculation` mit. Übernehmen Sie es in den Bericht, damit Leserinnen und Leser die Herkunft sehen.

API-Konsole

Anfrage zusammenstellen, Code kopieren und — angemeldet und mit eigenem Schlüssel — wirklich ausführen. Die Konsole führt ausschließlich lesende Aufrufe aus.

GET https://api.elyph.io/v1/metrics?limit=10

Schlüssel der Kennzahl, etwa `actions_overdue`.

Nur Werte ab diesem Stichtag (Datum).

Anzahl der Objekte je Seite, 1 bis 200. Standard 50.

Fortsetzungsmarke aus `page.next` der vorherigen Antwort. Keine Seitenzahl.

curl
curl -sS "https://api.elyph.io/v1/metrics?limit=10" \
  -H "Authorization: Bearer $ELYPH_API_KEY"

Echttest

Nach der Anmeldung führen Sie dieselbe Anfrage hier mit Ihrem eigenen Schlüssel aus. So sieht eine echte Antwort aus:

Beispielantwort
{
  "data": [
    {
      "metric": "actions_overdue",
      "value": 7,
      "captured_on": "2026-01-31",
      "calculation": "Tageswert der Kennzahl actions_overdue, berechnet aus den Mandantendaten zum Stichtag.",
      "updated_at": "2026-01-31T02:15:00Z"
    }
  ],
  "page": {
    "next": null,
    "limit": 10
  },
  "rate": {
    "limit": 120,
    "remaining": 118,
    "reset_at": "2026-02-01T10:31:00Z"
  }
}

Ergebnis

Ihre Berichte greifen auf dieselben Zahlen zu, die auch in elyph angezeigt werden.

Häufige Stolpersteine

  • Kennzahlen selbst nachrechnen: Nutzen Sie die gelieferten Werte samt Berechnungsangabe, sonst weichen Bericht und Portal voneinander ab.
  • Befragungsdaten erwarten: Sie sind ausschließlich aggregiert verfügbar — Anonymität geht vor.

Verwandte Artikel