Um die Soldo Business API in Ihrem Produktionskonto zu nutzen, müssen Sie eine Anwendung in der Soldo Web-App erstellen. Dieser Vorgang generiert die Zugangsdaten, mit denen Ihr System sich sicher bei der API authentifiziert.
Anwendung erstellen
- Melden Sie sich in der Soldo Web-App an.
- Gehen Sie über das Hauptnavigationsmenü zu Integrationen > Business API.
- Wählen Sie Anwendung erstellen.
- Geben Sie einen Namen für Ihre Anwendung ein.
- Geben Sie einen öffentlichen Schlüssel ein. Sie müssen ein gültiges RSA-2048-Bit-Schlüsselpaar im PEM-Format generieren.
Was ist ein Schlüsselpaar?
- Öffentlicher Schlüssel: Wird mit Soldo geteilt. Denken Sie daran wie an einen Benutzernamen – er identifiziert Ihre Anwendung.
- Privater Schlüssel: Wird geheim gehalten. Er wird verwendet, um Ihre API-Anfragen sicher zu signieren.
Anweisungen zum Erstellen eines Schlüsselpaares mit openssl finden Sie während des Einrichtungsprozesses.
- Wählen Sie Weiter.
- Wählen Sie die Scopes aus, die Ihre Anwendung benötigt, und klicken Sie dann auf Weiter. Sie können diese später bei Bedarf bearbeiten.
- Überprüfen Sie Ihre Einstellungen und bestätigen Sie die Geschäftsbedingungen.
- Wählen Sie Anwendung erstellen
Nach der Erstellung werden Ihre Zugangsdaten in einem Popup angezeigt:
- Client-ID – identifiziert Ihre Anwendung
- Client-Secret – wird für die Standardauthentifizierung verwendet
- Fingerprint-Token – wird für die erweiterte Authentifizierung oder das Herunterladen von Anhängen verwendet
Was passiert, wenn ich meine API-Zugangsdaten verliere?
Sie können diese jederzeit neu generieren. Gehen Sie zu Integrationen > Business API, wählen Sie die Anwendung aus und klicken Sie auf Zugangsdaten neu generieren. Dadurch werden ein neues Client-Secret und ein neuer Fingerprint-Token generiert. Ihre Client-ID bleibt gleich.
Nächste Schritte
Nachdem Sie Ihre Anwendung in der Web-App erstellt und Ihre Zugangsdaten generiert haben, sind Sie bereit, mit der Soldo Business API zu starten.
Die vollständige API-Dokumentation finden Sie in unserem Business API Developer Portal.