Zurück zum Hilfecenter

Schnittstelle: Rezepte

Rezept: Überfällige Maßnahmen täglich ins Ticketsystem

Ein Skript, das offene Maßnahmen mit abgelaufenem Termin holt und Aufgaben erzeugt.

Für wen

IT und Entwicklerinnen und Entwickler.

Voraussetzungen

Schlüssel mit `actions:read` Zugang zu Ihrem Ticketsystem

Schritt für Schritt

  1. 1

    Abfrage festlegen

    Offene Maßnahmen mit Termin bis heute: Filter `status=open` und `due_before` mit dem heutigen Datum.

    curl
    curl -sS "https://api.elyph.io/v1/actions?status=open&due_before=2026-02-01&limit=200" \
  -H "Authorization: Bearer $ELYPH_API_KEY"
  2. 2

    Skript einrichten

    Das Skript blättert vollständig, erzeugt je Maßnahme eine Aufgabe und merkt sich die bereits übertragenen Nummern.

    Node.js
    const key = process.env.ELYPH_API_KEY;
const today = new Date().toISOString().slice(0, 10);

async function overdueActions() {
  const rows = [];
  let page = null;
  do {
    const query = new URLSearchParams({ status: "open", due_before: today, limit: "200" });
    if (page) query.set("page", page);
    const response = await fetch(`https://api.elyph.io/v1/actions?${query}`, {
      headers: { Authorization: `Bearer ${key}` },
    });
    if (!response.ok) throw new Error(await response.text());
    const payload = await response.json();
    rows.push(...payload.data);
    page = payload.page.next;
  } while (page);
  return rows;
}

for (const action of await overdueActions()) {
  await createTicket({
    externalId: action.reference,                 // verhindert Doppelte
    title: `Überfällig: ${action.title}`,
    assignee: action.owner?.email ?? null,
    due: action.due_date,
    site: action.site?.name ?? "—",
    link: `https://elyph.io/massnahmen/${action.reference}`,
  });
}
  3. 3

    Termin fortschreiben

    Wird die Aufgabe im Zielsystem erledigt, kann das Skript den Status in elyph zurückschreiben.

    curl
    curl -sS "https://api.elyph.io/v1/actions/MAS-2026-233" \
  -H "Authorization: Bearer $ELYPH_API_KEY" \
  -H "Content-Type: application/json" \
  -X PATCH \
  -d '{
  "status": "done",
  "implemented_at": "2026-02-10T14:00:00Z"
}'
  4. 4

    Täglich ausführen

    Als geplanten Lauf früh morgens einrichten. Ein Lauf mit wenigen hundert Maßnahmen bleibt weit unter der Abfragegrenze.

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/actions?limit=10

Statuswert exakt wie im Feld `status`.

Nur Objekte mit Termin bis einschließlich diesem Datum.

Kennung des Standorts (UUID der Organisationseinheit).

Nur Objekte, die seit diesem Zeitpunkt geändert wurden (ISO 8601). Grundlage jeder Synchronisation.

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/actions?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": [
    {
      "reference": "MAS-2026-233",
      "title": "Zweihandschaltung instand setzen",
      "type": "technisch",
      "status": "in_progress",
      "priority": "hoch",
      "due_date": "2026-02-14",
      "owner": {
        "name": "Marco List",
        "email": "marco.list@example.com"
      },
      "site": {
        "reference": "WN",
        "name": "Werk Nord"
      },
      "origin": {
        "type": "assessment",
        "reference": "GBU-2026-014"
      },
      "effectiveness_check": {
        "required": true,
        "done": false,
        "result": null,
        "due_at": "2026-03-15"
      },
      "implemented_at": null,
      "completed_at": null,
      "updated_at": "2026-01-21T11:05:00Z"
    }
  ],
  "page": {
    "next": null,
    "limit": 10
  },
  "rate": {
    "limit": 120,
    "remaining": 118,
    "reset_at": "2026-02-01T10:31:00Z"
  }
}

Ergebnis

Verantwortliche sehen überfällige Maßnahmen in ihrem gewohnten Werkzeug — ohne doppelte Pflege.

Häufige Stolpersteine

  • Ohne stabile Kennung Aufgaben erzeugen: Nutzen Sie `reference` als externe Kennung, sonst entstehen täglich Doppelte.
  • Wirksamkeitskontrolle über die Schnittstelle abschließen wollen: Sie bleibt der Oberfläche vorbehalten.

Verwandte Artikel