Richtlinie für Business-Produkte – Inhaltsverzeichnis

ESET Cloud-Konsolen Anwendungsprogrammierschnittstellen (API)

Um zu verstehen, wie Änderungen Ihre Integration beeinflussen, ist es wichtig, zwischen dem Gateway und den Anwendungsprogrammierschnittstellen-Kategorien, die es bedient, zu unterscheiden.

ESET Connect (Gateway)

ESET Connect ist ein cloud-gehostetes Gateway, das vollständig von ESET verwaltet wird. Sie fungiert als Einstiegspunkt zwischen dem Client und den Backend-Diensten der folgenden ESET Cloud-Dienste:

ESET PROTECT (Cloud)

ESET Inspect

ESET Cloud Office Security

ESET Connect API-Kategorien

Das Gateway bietet Zugriff auf spezifische API-Sets, die in Kategorien organisiert sind.

Versionsverwaltung

Jede API-Kategorie hat ihren eigenen unabhängigen Versionszyklus. Dies ist die Version, die Sie in Ihrem Codelink angeben (z. B. /v1/groups).

Impakt

Updates der ESET Connect API-Kategorien können die API-Aufrufe ändern.

End-of-Life-Policy

Kategorie E der Unterstützungsrichtlinie

Richtlinie zu grundlegenden Änderungen

ESET kann Änderungen ohne vorherige Vorankündigung vornehmen, wenn die Änderung als nicht beeinträchtigt gilt.


Benachrichtigung

ESET wird angemessene Anstrengungen unternehmen, Sie rechtzeitig über aktuelle Änderungen zu informieren, um sich an diese anzupassen.

Eine grundlegende Änderung ist eine Änderung an Anwendungsprogrammierschnittstellen (APIs), bei der Änderungen an einer Anwendung erforderlich sein können, um Störungen der Integration zu vermeiden oder Änderungen zur Aufrechterhaltung der Kompatibilität erforderlich zu machen.

Im Folgenden sind einige Beispiele für Änderungen, die wir als grundlegende Änderungen betrachten:

geändertes Antwortformat,

Feld umbenannt,

Feld entfernt,

Datentypänderung,

Fehlercode-Änderung,

Änderung der Geschäftslogik.

Grundlegende Änderungen können auch durch Änderungen in Bezug auf Authentifizierung, Berechtigungsbereich, Ratenbegrenzungen, Transport-/URL-Änderungen und andere Faktoren verursacht werden.

Eine nicht-grundlegende Änderung ist eine Veränderung, an die Sie sich nach eigenem Ermessen und Tempo anpassen können, ohne dass es zu Unterbrechungen kommt.

Im Folgenden sind einige Beispiele für Änderungen, die wir als nicht-grundlegende Änderungen ansehen:

neues Feld hinzugefügt,

neuer optionaler Parameter hinzugefügt,

neuer Wert hinzugefügt,

erhöhtes Ratenlimit,

Unterstützung für weitere Formate usw.

Übergangszeitraum

Während der Übergangsphase, in dem der Zeitraum bleibt, in dem eine vorherige Version einer API-Kategorie nach Einführung der neuen API-Kategorie oder funktionaler Ersatz verfügbar ist, bleibt die vorherige Version für eine definierte, begrenzte Support-Periode weiterhin verfügbar. ESET wird angemessene Anstrengungen unternehmen, um die Kompatibilität sicherzustellen und den Kunden genügend Zeit zu geben, sich an diese Veränderungen anzupassen.

Der eingeschränkte Support der ESET Connect API-Kategorien-Version beginnt am angekündigten Datum, in der Regel am öffentlichen Ankündigungsdatum für Endkunden. Die Version der ESET Connect API-Kategorien wird in den Limited Support umgestellt und wird während des gesamten Zeitraums bis zum Enddatum verfügbar sein. Nach Ablauf des begrenzten Supports wird die Version der ESET Connect API-Kategorien nicht mehr verfügbar sein.

Versionierungsregeln

Grundlegende Änderungen

Jede Version mit einer grundlegenden Änderung wird in der Dokumentation klar markiert.

Nicht-grundlegende Änderungen

Wenn eine Version nur nicht-grundlegende Änderungen enthält, bleibt die API-Kategorie-Version gleich. Details finden Sie in der ESET Connect Online-Hilfedokumentation.