Recommendations to Integration of Enterprise API

Documentation (English)

For the German version, please scroll down to “Dokumentation (Deutsch)”

Initial Preparation

Define Objectives: Clearly outline the goals and benefits of integrating with the Enterprise API.

Review Documentation: Ensure you have access to comprehensive Enterprise API documentation, including endpoints, parameters, and response formats.

API Access: Obtain necessary credentials, such as client_id and subscription key (sent by email) and client_Secret (sent by sms), required for authentication and authorization.

Integration Planning

Determine Scope: Decide which API endpoints and functionalities are relevant for your integration.

Plan for Error Handling: Develop strategies for managing and responding to potential errors or exceptions.

Authentication and Authorization

Authentication Method: Implement the required authentication mechanism (OAuth tokens).

Authorization Scope: Ensure that your API requests adhere to the permissions and scopes defined by the Enterprise API.

Secure Storage: Safeguard API credentials and tokens to prevent unauthorized access.

Check Changelog Regularly

Monitor Updates: Regularly review the API changelog to stay informed about new features, enhancements, and breaking changes to the Enterprise API.

Update Integration: Adjust your integration as needed to accommodate new updates or changes to ensure compatibility and take advantage of new functionality.

Documentation of Changes: Keep track of how updates may affect your application and update your documentation and code accordingly.

Dokumentation (Deutsch)

Hier finden Sie die deutsche Dokumentation.

Empfehlungen zur Integration der Enterprise API

Vorbereitung

Ziele definieren: Legen Sie klar die Ziele und Vorteile der Integration mit der Enterprise API fest.

Dokumentation überprüfen: Stellen Sie sicher, dass Sie Zugriff auf umfassende Dokumentationen der Enterprise API haben, einschließlich Endpunkten, Parametern und Antwortformaten.

API-Zugriff: Erhalten Sie die erforderlichen Anmeldeinformationen, wie client_id und Abonnement(subscription)-schlüssel (per E-Mail gesendet) sowie client_secret (per SMS gesendet), die für die Authentifizierung und Autorisierung benötigt werden.

Integrationsplanung

Umfang bestimmen: Entscheiden Sie, welche API-Endpunkte und Funktionen für Ihre Integration relevant sind.

Planung für Fehlerbehandlung: Entwickeln Sie Strategien für den Umgang mit und die Reaktion auf mögliche Fehler oder Ausnahmen.

Authentifizierung und Autorisierung

Authentifizierungsmethode: Implementieren Sie den erforderlichen Authentifizierungsmechanismus (OAuth-Token).

Autorisierungsumfang: Stellen Sie sicher, dass Ihre API-Anfragen den Berechtigungen und Geltungsbereichen entsprechen, die von der Enterprise API definiert sind.

Sichere Speicherung: Schützen Sie die API-Anmeldeinformationen und Token, um unbefugten Zugriff zu verhindern.

Changelog regelmäßig überprüfen

Updates überwachen: Überprüfen Sie regelmäßig das API changelog , um über neue Funktionen, Verbesserungen und breaking Changes der Enterprise API informiert zu bleiben.

Integration aktualisieren: Passen Sie Ihre Integration bei Bedarf an, um neue Updates oder Änderungen zu berücksichtigen und sicherzustellen, dass die Kompatibilität gewahrt bleibt und neue Funktionen genutzt werden.

Dokumentation der Änderungen: Behalten Sie im Auge, wie Updates Ihre Anwendung beeinflussen können, und aktualisieren Sie Ihre Dokumentation und Ihren Code entsprechend.