Zum Inhalt

.NET SDK

Das SDK wird als Open-Source-Projekt veröffentlicht und ist über den NuGet-Paketmanager verfügbar.

Installation

Sie können das Paket über die .NET-CLI oder den NuGet-Paketmanager in Visual Studio installieren. Mit der .NET-CLI: dotnet add package Daktela.Connector Mit der Paket-Manager-Konsole: Install-Package Daktela.Connector

Implementierung und Verwendung

Das .NET SDK folgt gängigen modernen Entwicklungsmustern. Ausführliche Anweisungen dazu, wie Sie den Connector innerhalb des Lebenszyklus Ihrer Anwendung registrieren und verwenden, finden Sie in der Datei README.md im offiziellen GitHub-Repository. Die Dokumentation im Repository enthält konkrete Details zu:

  • Dependency Injection: Wie Sie IServiceCollection verwenden, um den Daktela-Client zu registrieren.
  • Konfiguration: Binden Ihrer Instanz-URL und Ihres API-Zugriffstokens aus appsettings.json.
  • Stark typisierte Anfragen: Arbeiten mit den Modellen Contact, Activity und Ticket.
  • Asynchrone Operationen: Nutzung von async/await für nicht blockierende API-Aufrufe.

Best Practices

  • Sichere Konfiguration: Verwenden Sie das Options Pattern in .NET, um Ihre Daktela-Anmeldedaten beim Start zu validieren. Checken Sie Ihre API-Token niemals in die Versionsverwaltung ein; verwenden Sie User Secrets für die lokale Entwicklung und Umgebungsvariablen oder Azure Key Vault für die Produktion.
  • HttpClient Factory: Das SDK ist für die Zusammenarbeit mit IHttpClientFactory ausgelegt. Dies gewährleistet eine effiziente Socket-Verwaltung und verhindert häufige Probleme wie die Erschöpfung von Ports.
  • JSON-Serialisierung: Das SDK verwendet System.Text.Json. Wenn Sie die Modelle erweitern, stellen Sie sicher, dass Sie die passenden Attribute verwenden, um den Namenskonventionen der Daktela-API zu entsprechen.