Anleitung · Schnittstelle (API)

Ohne Programmieren: Postman, n8n, Make, Excel

DSGVO Server & Hosting in DE BSI Allianz für Cybersicherheit BSI Allianz für Cybersicherheit ProHunde ProHunde-Kooperation BVZ Berufsverband zertifizierter Hundetrainer BVZ-Kooperation

Ohne Programmieren: Postman, n8n, Make, Excel

Für viele Aufgaben brauchst du keine Zeile Code. Diese Seite zeigt die gängigen Werkzeuge und wie du sie anbindest.

1. Postman, Insomnia, Bruno

Das sind Werkzeuge zum Ausprobieren von Schnittstellen — nützlich, bevor du irgendetwas baust.

Der bequeme Weg: Lade unter https://deine-adresse.de/api/beispiele/ die Datei petworkers-api.postman_collection.json herunter und importiere sie. Danach setzt du im Reiter Variables zwei Werte:

baseurlhttps://deine-adresse.de/api/v1
apikeydein Schlüssel

Die Sammlung ist nach Bereichen gegliedert und enthält zu jedem Bereich die üblichen Anfragen — Liste, Einzelabruf, Anlegen, Ändern, Löschen — samt vorbereiteter Filter zum Einschalten.

Der immer aktuelle Weg: Importiere direkt die Beschreibungsdatei

https://deine-adresse.de/api/v1/openapi.json

Sie wird bei jedem Abruf frisch erzeugt und ist deshalb nie veraltet. In Postman: Import → Link. Der Schlüssel gehört dann noch als Kopfzeile Authorization: Bearer … dazu.

2. n8n

n8n baut Abläufe zusammen, ohne dass du programmierst. Die Anbindung:

  1. Neuen Workflow anlegen, Knoten HTTP Request hinzufügen.
  2. Authentication: Generic Credential Type → Header Auth.
  3. Neue Zugangsdaten anlegen: Name Authorization, Wert Bearer 3f7c… (mit dem Wort „Bearer“ und einem Leerzeichen davor).
  4. URL: https://deine-adresse.de/api/v1/contacts
  5. Method: GET
  6. Bei Send Query Parameters die Filter eintragen, zum Beispiel per_page = 100.

Für Filter mit Klammern trägst du den Namen genau so ein: lastname[like] als Parametername, Mül als Wert.

Ein typischer Ablauf: Schedule Trigger (täglich um 6 Uhr) → HTTP Request (geänderte Kontakte holen) → Loop → dein Zielsystem.

3. Make (früher Integromat)

Make hat keinen eigenen PetWorkers-Baustein, aber den allgemeinen HTTP-Baustein — der reicht vollständig.

  1. Modul HTTP → Make a request hinzufügen.
  2. URL: die gewünschte Adresse, zum Beispiel https://deine-adresse.de/api/v1/contacts?per_page=100
  3. Method: GET
  4. Unter Headers einen Eintrag anlegen: Name Authorization, Wert Bearer 3f7c…
  5. Parse response: einschalten — dann kannst du direkt mit data[] weiterarbeiten.

4. Zapier

Über Webhooks by Zapier → Custom Request. Kopfzeile Authorization mit dem Wert Bearer 3f7c…, Methode und Adresse wie oben. Zapier zeigt die Antwort danach als Feldliste an.

5. Excel und Power BI

Beide benutzen Power Query. So holst du eine Liste in eine Tabelle:

  1. In Excel: Daten → Daten abrufen → Aus anderen Quellen → Aus dem Web.
  2. Auf Erweitert klicken.
  3. Unter URL-Teile die Adresse eintragen.
  4. Unter HTTP-Anforderungsheaderparameter: Authorization = Bearer 3f7c…

Wer lieber direkt in der Formelsprache arbeitet:

let
    Basis    = "https://deine-adresse.de/api/v1",
    Schluessel = "3f7c9a2e-4b81-4d6f-9a03-7c5e12f8ab44",

    Antwort = Json.Document(
        Web.Contents(Basis, [
            RelativePath = "contacts",
            Query        = [ per_page = "500",
                             fields = "id,lastname,firstname,email" ],
            Headers      = [ Authorization = "Bearer " & Schluessel ]
        ])
    ),

    Zeilen  = Table.FromList(Antwort[data], Splitter.SplitByNothing()),
    Spalten = Table.ExpandRecordColumn(Zeilen, "Column1",
                {"id", "lastname", "firstname", "email", "city"},
                {"Kennung", "Nachname", "Vorname", "E-Mail", "Ort"})
in
    Spalten

Mehr als 500 Datensätze holst du, indem du die Abfrage in eine Funktion packst und die Seiten durchläufst. Power Query kann das über List.Generate.

6. Google Sheets

Über Erweiterungen → Apps Script:

function petworkersKontakte() {
  const BASE = 'https://deine-adresse.de/api/v1';
  const KEY  = '3f7c9a2e-4b81-4d6f-9a03-7c5e12f8ab44';

  const antwort = UrlFetchApp.fetch(
    BASE + '/contacts?per_page=500&fields=id,lastname,firstname,email',
    { headers: { Authorization: 'Bearer ' + KEY } }
  );

  const daten = JSON.parse(antwort.getContentText()).data;
  const blatt = SpreadsheetApp.getActiveSheet();

  blatt.clear();
  blatt.appendRow(['Kennung', 'Nachname', 'Vorname', 'E-Mail']);
  daten.forEach(k => blatt.appendRow([k.id, k.lastname, k.firstname, k.email]));
}

7. Eine Überwachung einrichten

Der Pfad /api/v1/health eignet sich für jedes Überwachungswerkzeug (Uptime Kuma, Better Stack, Zabbix). Er antwortet mit Status 200 und:

{ "data": { "status": "ok", "database": "ok",
            "time": "2026-08-17T22:00:00+02:00" } }

Auch dieser Pfad braucht einen gültigen Schlüssel. Leg dafür am besten einen eigenen an: Stufe „Mitarbeiter“, Schreiben erlauben aus, Bereich auf etwas Belangloses beschränkt. Dann kann er nichts, außer zu melden, dass es die Software noch gibt.

Zeit für den Wechsel

Frage noch offen?

Wenn dir in der Anleitung etwas fehlt — schreib uns. Wir nehmen Themen aus Support-Tickets oft sofort als neue Anleitung auf.

DSGVO-konform Server in Deutschland Persönlicher Support