bexio-dotnet

Worum es geht

bexio-dotnet ist ein .NET-Client für die bexio-API. Er deckt alle dokumentierten Operationen der API-Versionen 2.0 und 3.0 ab (272): Verkauf (Offerten, Bestellungen, Rechnungen, Mahnungen, Lieferscheine), Kontakte, Artikel, Projekte und Zeiterfassung, Buchhaltung, Bankkonten, Dateien und Einkaufsbestellungen. Die Endpunkte und Modelle werden aus der offiziellen API-Beschreibung von bexio erzeugt.

Installieren

Das Paket Bexio.DotNet gibt es auf NuGet: dotnet add package Bexio.DotNet. Die Anleitung steht in der Dokumentation, der Quellcode ist auf GitHub.

Was drin steckt

• Anmeldung: persönliches Zugriffstoken oder OAuth2 für in bexio registrierte Apps, inklusive automatischer Token-Erneuerung und Token-Speicher für mehrere bexio-Konten
• Einfacher Einstieg: ein IBexioClient gruppiert alle Endpunkte nach API-Version, zum Beispiel client.V2.Invoices oder client.V3.Currencies
• Robust: alle Aufrufe auch asynchron, automatische Wiederholung bei Rate-Limit (429), seitenweise Abfrage grosser Listen
• Sauber gebaut: HttpClient mit IHttpClientFactory, Dependency Injection, Unit-Tests und eine CI/CD-Pipeline auf GitHub Actions, Veröffentlichung auf NuGet per Trusted Publishing
• Läuft auf .NET 10 (LTS)

Aufbau

Pro bexio-Konto gibt es einen Client. Jeder Endpunkt kennt seine API-Version und seinen Pfad, die Transportschicht kümmert sich um Token, Basis-URL und Wiederholungen.

OAuth2 für registrierte Apps

Wer eine App bei bexio registriert hat, meldet sich mit dem Authorization-Code-Flow an. Die Bibliothek erneuert das Token automatisch und speichert das jeweils neueste Refresh-Token im Token-Speicher, pro Kunde ein eigener.

Stand

Die Bibliothek ist gegen die offizielle API-Beschreibung getestet, aber noch nicht gegen die echte bexio-API. Das Projekt ist Open Source (MIT), Rückmeldungen und Pull Requests sind willkommen: Issues auf GitHub.