REST API v2

Integriere alles
in die Logzi API

Wir bieten zu jedem Abonnement RESTful-API-Zugriff.
Verbinde deinen Webshop, dein Produktionssystem, dein CRM oder jede Insellösung mit Logzi ERP – mit JSON-Antworten und API-Schlüssel-Authentifizierung.

500+ Endpunkte JSON API-Schlüssel-Authentifizierung
terminal — logzi-api-demo
# Partnerliste mit API-Schlüssel abrufen
curl -X GET \
  "https://app.logzi.com/api/partner/list?list_count=5" \
  -H "X-API-KEY: your-secret-api-key"

# ✓ 200 OK — JSON-Antwort:
{
  "result": { "code": 1, "message": null },
  "data": [
    {
      "id": 42,
      "company_name": "Beispiel GmbH",
      "tax_number": "12345678-1-01"
    }
  ]
}
Authentifizierung

API-Schlüssel-Identifikation

Für jede API-Anfrage benötigst du deinen eindeutigen API-Schlüssel, den du in deinem Logzi-Konto unter Einstellungen → Integration findest.

3 Schritte zum Start

1
API-Schlüssel generieren

Erstelle deinen API-Schlüssel auf der Seite Einstellungen → Integration in deinem Konto. In jeder Abo-Stufe enthalten.

2
Sende ihn bei jeder Anfrage

Füge deinen Schlüssel in den X-API-KEY-Header jeder HTTP-Anfrage ein — sowohl bei GET- als auch bei POST-Aufrufen.

3
JSON-Antwort verarbeiten

Prüfe den Wert von result.code: 1 = Erfolg, 0 = Fehler. Das Feld data enthält die ERP-Daten.

Authentifizierungsbeispiel – Header senden
# cURL – X-API-KEY-Header für jede Anfrage
curl -X GET \
  "https://app.logzi.com/api/partner/get?id=42" \
  -H "X-API-KEY: abc123def456ghi789" \
  -H "Content-Type: application/json"

# PHP – cURL-Header festlegen
$ch = curl_init();
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: abc123def456ghi789',
    'Content-Type: application/json',
]);

# Antwort bei ungültigem Schlüssel:
{
  "result": {
    "code": 0,
    "message": "Unauthorized"
  },
  "data": null
}
Schnellstart

Dein erster API-Aufruf in 5 Minuten

Wähle deine Programmiersprache und füge den Code ein – er fragt die Partnerliste von der Logzi API ab.

<?php

require_once 'vendor/autoload.php';

use Logzi\Api\LogziClient;

// 1. Client mit deinem API-Schlüssel initialisieren
$client = new LogziClient([
    'api_key'  => 'your-secret-api-key',
    'base_url' => 'https://app.logzi.com/api/',
]);

// 2. Partnerliste abrufen (paginiert)
$response = $client->partner()->list([
    'list_offset' => 0,
    'list_count'  => 25,
]);

// 3. Ergebnis verarbeiten
if ($response['result']['code'] === 1) {
    foreach ($response['data'] as $partner) {
        echo $partner['id'] . ' – ' . $partner['company_name'] . "\n";
    }
} else {
    echo 'Fehler: ' . $response['result']['message'];
}
# Partnerliste – einfache GET-Anfrage
curl -X GET \
  "https://app.logzi.com/api/partner/list?list_offset=0&list_count=25" \
  -H "X-API-KEY: your-secret-api-key" \
  -H "Content-Type: application/json"

# Filterung mit dem Parameter list_condition (nur Kunden)
curl -G \
  "https://app.logzi.com/api/partner/list" \
  --data-urlencode "list_condition[is_customer]=1" \
  --data-urlencode "list_count=50" \
  -H "X-API-KEY: your-secret-api-key"

# Suche nach Firmenname
curl -X GET \
  "https://app.logzi.com/api/partner/get?company_name=P%C3%A9lda+Kft." \
  -H "X-API-KEY: your-secret-api-key"
const API_KEY  = 'your-secret-api-key';
const BASE_URL = 'https://app.logzi.com/api';

// Allgemeine GET-Hilfsfunktion
async function logziGet(endpoint, params = {}) {
    const qs  = new URLSearchParams(params).toString();
    const res = await fetch(`${BASE_URL}/${endpoint}?${qs}`, {
        method:  'GET',
        headers: {
            'X-API-KEY':    API_KEY,
            'Content-Type': 'application/json',
        },
    });
    return res.json();
}

// Partner auflisten
const result = await logziGet('partner/list', {
    list_offset: 0,
    list_count:  25,
});

if (result.result.code === 1) {
    result.data.forEach(p => console.log(p.company_name));
}
import requests

API_KEY  = "your-secret-api-key"
BASE_URL = "https://app.logzi.com/api"

headers = {
    "X-API-KEY":    API_KEY,
    "Content-Type": "application/json",
}

# Partnerliste abrufen
response = requests.get(
    f"{BASE_URL}/partner/list",
    headers=headers,
    params={"list_offset": 0, "list_count": 25},
)

data = response.json()

if data["result"]["code"] == 1:
    for partner in data["data"]:
        print(partner["company_name"])
else:
    print("Fehler:", data["result"]["message"])
  • Keine versteckten Kosten
  • HTTP GET & POST
  • JSON-Standard
  • PHP SDK auf GitHub
Standard

JSON-Antwortstruktur

Jeder API-Endpunkt antwortet mit derselben JSON-Struktur. Der Wert von result.code zeigt an, ob der Aufruf erfolgreich war: 1 = Erfolg, 0 = Fehler.

Erfolgreiche Antwort HTTP 200 · code: 1
{
  "result": {
    "code": 1,        ← Erfolg
    "message": null  ← Keine Fehlermeldung
  },
  "data": {
    "id": 42,
    "company_name": "Beispiel GmbH",
    // ... weitere Felder
  }
}
Fehlerhafte / Leere Antwort HTTP 200 · code: 0
{
  "result": {
    "code": 0,                 ← Fehler
    "message": "Not found"  ← Fehlermeldung
  },
  "data": null              ← Keine Daten
}

// Mögliche Meldungen:
// "Unauthorized" – ungültiger API-Schlüssel
// "Not found"    – Ressource existiert nicht
Bewährte Praktiken

Rate Limit & Tipps

Für optimale Leistung und Sicherheit beachte bitte die folgenden Grenzwerte und Empfehlungen.

Rate Limit

Pro Endpunkt sind maximal 100 Anfragen / 30 Sekunden erlaubt. Bei Überschreitung erhältst du eine HTTP 429-Antwort.

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1712345678
Paginierung

Verwende bei Listen-Endpunkten immer die Parameter list_offset und list_count, um Speicher und Geschwindigkeit zu optimieren.

# Seite 1 (Elemente 0–24)
?list_offset=0&list_count=25

# Seite 2 (Elemente 25–49)
?list_offset=25&list_count=25
Sicherheit

Bewahre deinen API-Schlüssel immer sicher auf – gib ihn niemals im Quellcode, im Frontend-JS oder in einem öffentlichen Repository preis.

  • In einer .env-Datei speichern
  • Nur serverseitig verwenden
  • Bei Kompromittierung austauschen
  • Nicht ohne .gitignore committen!

Finde, was du suchst

Wir versuchen, alles Wissenswerte über die Logzi-Software an einem Ort zu sammeln – unten nach Kategorien geordnet.

FAQ

Häufig gestellte Fragen und Antworten zu unserer Software, alles an einem Ort.

Dokumentation

Dokumentation zur Software mit Modulen, Funktionen und SDK-Aufrufen.

Hilfe anfordern

Eröffne ein Ticket, auf das unsere Kollegen oder die Community bald reagieren und dir helfen.

Software Development Kit

Klonen, integrieren, loslegen!

Verbinde deinen Webshop, dein Produktionssystem oder jede Insellösung mit der Logzi API-Schnittstelle. Mit dem SDK kannst du die meisten Integrationen in wenigen Minuten umsetzen.

  • Halte deine Daten aktuell
  • Arbeite im Team
  • Automatisiere Prozesse
  • Open Source SDK

Registriere dich jetzt,
zahle später!

Teste es 3 Tage kostenlos, ohne Risiko und Verpflichtung!