> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ibana.io/llms.txt
> Use this file to discover all available pages before exploring further.

# REST-API: ibana an eigene Systeme anbinden

> Wie Sie einen API-Schlüssel erstellen und Anfragen an die öffentliche ibana-API senden.

Über die REST-API lesen und schreiben Ihre eigenen Systeme Daten in ibana, etwa Stammdaten aus Ihrer Buchhaltungssoftware oder Bestellungen aus Ihrem Warenwirtschaftssystem. Alle Endpunkte mit Parametern und Antworten stehen in der [API Reference](https://docs.ibana.io/api-reference/invoice/get-invoices.md).

## API-Schlüssel erstellen

API-Schlüssel verwalten Admins unter **Einstellungen → API & MCP** im Abschnitt **API-Schlüssel**.

1. Klicken Sie auf `Neuen Schlüssel erstellen`.
2. Klicken Sie im Dialog auf `API-Schlüssel erstellen`.
3. Kopieren Sie den Schlüssel mit `Kopieren` und legen Sie ihn sicher ab. ibana zeigt ihn nur dieses eine Mal an.

Die Liste zeigt danach für jeden Schlüssel die **Schlüssel-ID** (über das Augen-Symbol einblendbar) und wer ihn erstellt hat.

* **Ein Schlüssel pro Person:** Jede Person hat in einer Organisation höchstens einen Schlüssel. Erstellen Sie einen neuen, ersetzt er Ihren bisherigen; Anfragen mit dem alten Schlüssel lehnt ibana ab.
* **Schlüssel löschen:** `Löschen` neben dem Schlüssel. Anfragen mit diesem Schlüssel lehnt ibana ab sofort ab.

> [!WARNING]
>
> Ein API-Schlüssel greift auf die Daten der gesamten Organisation zu, unabhängig von der Rolle und den Berechtigungen der Person, die ihn erstellt hat. Behandeln Sie ihn wie ein Passwort und löschen Sie Schlüssel, die nicht mehr gebraucht werden.

## Einstellungen → API & MCP

Der Tab bündelt die beiden Zugänge von außen: API-Schlüssel für Systeme, die die REST-API aufrufen, und den Schalter für KI-Clients, die sich per [MCP](https://docs.ibana.io/documentation/integrations/ibana-mit-ki-clients-verbinden.md) mit dem persönlichen Login verbinden. Nur Admins sehen den Tab.

| Element | Was es bewirkt | Standard |
| - | - | - |
| `Neuen Schlüssel erstellen` | Öffnet den Dialog, in dem Sie mit `API-Schlüssel erstellen` einen Schlüssel für sich erzeugen. Ein vorhandener Schlüssel von Ihnen wird dabei ersetzt. | – |
| **Schlüssel-ID** mit Augen-Symbol | Zeigt die Kennung des Schlüssels ein oder aus, damit Sie ihn z. B. in Protokollen wiedererkennen. Der Schlüssel selbst wird nicht mehr angezeigt. | ausgeblendet |
| **Erstellt von** | Person, zu der der Schlüssel gehört. | – |
| `Löschen` | Löscht den Schlüssel; Anfragen damit werden ab sofort abgelehnt. | – |
| **MCP-Zugriff für diese Organisation erlauben** | Erlaubt den Teammitgliedern, ibana aus einem KI-Client wie Claude oder Cursor zu verbinden. Ausschalten trennt alle MCP-Verbindungen der Organisation ab der nächsten Anfrage, etwa wenn Ihre Organisation Finanzdaten nicht in externen KI-Diensten verarbeiten lassen will. Wird sofort gespeichert. Nur sichtbar, wenn MCP für Ihre Organisation freigeschaltet ist. | eingeschaltet |

## Anfragen senden

| | |
| - | - |
| Basis-URL | `https://public-api.ibana.io` |
| Pfade | beginnen mit `/v1/`, z. B. `/v1/invoice` |
| Authentifizierung | Header `Authorization: Bearer <API-Schlüssel>` |

```bash theme={null}
curl https://public-api.ibana.io/v1/invoice \
  -H "Authorization: Bearer <API-Schlüssel>"
```

| Status | Bedeutung |
| - | - |
| `401` | Header fehlt, ist falsch aufgebaut oder der Schlüssel ist ungültig oder gelöscht. |
| `403` | Der Endpunkt gehört zu einem Modul, das für Ihre Organisation nicht freigeschaltet ist, z. B. benutzerdefinierte Felder. |
| `429` | Der Schlüssel hat sein Anfragelimit erreicht. Die Fehlermeldung nennt das Limit und den Zeitraum. |

## Was die API abdeckt

| Bereich | Endpunkte |
| - | - |
| [Eingangsrechnungen](https://docs.ibana.io/api-reference/invoice/get-invoices.md) | auflisten und abrufen, Download-Link zur Datei, Freigabe-Anforderung abrufen, benutzerdefinierte Felder setzen |
| [Ausgangsrechnungen](https://docs.ibana.io/api-reference/accounts-receivable/get-accounts-receivable-invoices.md) | auflisten, abrufen, ändern, löschen |
| [Geschäftspartner](https://docs.ibana.io/api-reference/counterparty/get-counterparties.md) | auflisten, abrufen, anlegen |
| [Zahlungen](https://docs.ibana.io/api-reference/transaction/get-transactions.md) | auflisten, abrufen, anlegen |
| [Kostenstellen](https://docs.ibana.io/api-reference/cost-center/get-cost-centers.md) | auflisten, abrufen, anlegen, ändern, löschen |
| [Sachkonten](https://docs.ibana.io/api-reference/ledger-account/get-ledger-accounts.md) | auflisten, abrufen, anlegen, ändern, löschen |
| [Bestellungen](https://docs.ibana.io/api-reference/purchase-order/get-all-purchase-orders.md) | auflisten, abrufen, anlegen, ändern, löschen; Lieferungen und Rechnungspositionen zu einer Bestellposition |
| [Lieferungen](https://docs.ibana.io/api-reference/delivery/get-all-deliveries.md) | auflisten, abrufen, anlegen, ändern, löschen |
| [Benutzerdefinierte Felder](https://docs.ibana.io/api-reference/custom-fields/get-custom-field-definitions.md) | Felddefinitionen abrufen |

## API oder MCP

Die REST-API ist für Systeme gedacht, die ohne Person laufen. Wer ibana aus einem KI-Client wie Claude oder ChatGPT nutzen will, verbindet sich über [MCP](https://docs.ibana.io/documentation/integrations/ibana-mit-ki-clients-verbinden.md) mit dem eigenen Login; dort gelten die persönlichen Berechtigungen, und API-Schlüssel werden nicht verwendet.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.