Die erste Anfrage an die API senden

3 Schritte·ca. 5 Min.·Stand: September 2026

Für alle, die selbst programmieren. Die API antwortet mit JSON, und jede Anfrage trägt den Schlüssel im Header.

ab Professional Teil des Plugins „API“. Ein Plugin installieren · Tarife vergleichen

Schritt 1 von 3

Schritt 1 von 3

The „API“ settings tab with the „API-Adresse“ card and a toast confirming the address was copied.

API-Adresse kopieren

Die Adresse Ihrer API steht in den Einstellungen unter den Schlüsseln.

  1. 1

    Öffnen Sie Einstellungen → „API“.

  2. 2

    Klicken Sie unter „Für Entwickler“ auf „API-Adresse“. Vendority kopiert die Adresse und meldet „Adresse kopiert“.

  3. 3

    Die Adresse endet auf /api, zum Beispiel https://ihr-betrieb.vendority.io/api.

Schritt 2 von 3

A terminal window with a curl request to the invoices endpoint and the returned JSON invoice data.

Anfrage senden

Bei jeder Anfrage senden Sie den Schlüssel im Authorization-Header mit.

  1. 1

    Öffnen Sie ein Terminal.

  2. 2

    Senden Sie diese Anfrage, mit Ihrer Adresse und Ihrem Schlüssel: curl -X POST https://ihr-betrieb.vendority.io/api/invoices -H "Authorization: Bearer vdy_…" -H "Content-Type: application/json" -d '{}'

  3. 3

    Die Antwort nennt unter totalItems die Zahl Ihrer Rechnungen und liefert unter items die ersten 50.

  4. 4

    Kommt 401 zurück, ist der Schlüssel falsch oder abgelaufen.

  5. 5

    Kommt 403 zurück, darf der Schlüssel keine Rechnungen sehen.

Schritt 3 von 3

Bildplatz
Screenshot fehlt: Die API-Referenz zeigt ihre Beschreibungen derzeit als rohe Übersetzungsschlüssel (siehe Funde, Punkt 9)
2560 × 1264 px empfohlen

API-Referenz öffnen

Die Referenz beschreibt alle Endpunkte, mit Beispielen zum Ausprobieren.

  1. 1

    Klicken Sie in Einstellungen → „API“ unter „Für Entwickler“ auf „API-Referenz“.

  2. 2

    Die Referenz liegt unter der Adresse Ihrer API mit /docs, also etwa https://ihr-betrieb.vendority.io/api/docs.

  3. 3

    Klappen Sie einen Endpunkt auf, um Parameter, Beispiele und mögliche Antworten zu sehen.

Geschafft.

Sie haben „Die erste Anfrage an die API senden“ von Anfang bis Ende durchgearbeitet.

Zurück zu „API“

Blättern auch mit ← und →