Wie erhalte ich Zugriff auf die API?

Die interaktive Dokumentation der Billnado API finden Sie unter api.billnado.be/documentation. Diese URL ist öffentlich zugänglich und darf frei verwendet und weitergegeben werden. Dort können Sie die verfügbaren Endpunkte, Anforderungsmodelle und Antworten einsehen. Für geschützte API-Aufrufe ist jedoch eine Authentifizierung erforderlich.

API-Definitionen

Die API-Dokumentation ist in mehrere Definitionen unterteilt, die verschiedenen Gruppen innerhalb der Software entsprechen. Beispiele dafür sind client, account, support und accountant. Jede Definition enthält die Endpunkte, die der jeweiligen Gruppe zugeordnet sind.

Sie können die gewünschte Definition in der Dokumentation auswählen. Die verfügbaren Endpunkte und der Zugriff darauf können je nach Definition unterschiedlich sein und hängen von Ihren Berechtigungen ab.

Authentifizierung

Die API-Dokumentation sieht zwei Authentifizierungsmethoden vor:

1. OAuth 2.0
2. Ein Personal Access Token (PAT)

OAuth 2.0

OAuth 2.0 ist derzeit die unterstützte Authentifizierungsmethode. Verwenden Sie diese Methode, um Ihrer Anwendung im Namen eines Billnado-Kontos sicheren Zugriff auf die API zu gewähren.

Personal Access Token

Die Unterstützung für Personal Access Tokens ist geplant, aber noch nicht verfügbar. Derzeit können Sie keinen PAT anfordern oder verwenden. Diese Möglichkeit wird in einer zukünftigen Version hinzugefügt.

Verwenden Sie bis dahin OAuth 2.0, um auf die Billnado API zuzugreifen.