--- title: "Erste Schritte mit der OVHcloud API" description: "Erfahren Sie hier, wie Sie die OVHcloud API verwenden" url: https://docs.ovhcloud.com/de/guides/manage-and-operate/api/first-steps lang: de lastUpdated: 2025-05-13 --- # Erste Schritte mit der OVHcloud API :::info Diese Übersetzung wurde durch unseren Partner SYSTRAN automatisch erstellt. In manchen Fällen können ungenaue Formulierungen verwendet worden sein, z.B. bei der Beschriftung von Schaltflächen oder technischen Details. Bitte ziehen Sie im Zweifelsfall die englische oder französische Fassung der Anleitung zu Rate. Möchten Sie mithelfen, diese Übersetzung zu verbessern? Dann nutzen Sie dazu bitte den Button "Beitragen" auf dieser Seite. ::: ## Ziel Die unter [https://api.ovh.com/](https://eu.api.ovh.com/) verfügbare API erlaubt es Ihnen, OVHcloud Produkte zu bestellen, zu verwalten, zu aktualisieren und zu konfigurieren, ohne ein grafisches Interface wie das Kundencenter zu verwenden. **Hier erfahren Sie, wie Sie die OVHcloud API verwenden und mit Ihren Anwendungen verbinden.** ## Voraussetzungen - Sie verfügen über einen aktiven OVHcloud Kunden-Account und dessen Zugangsdaten. - Sie sind auf der Webseite der [OVHcloud API](https://eu.api.ovh.com/). ## In der praktischen Anwendung :::warning OVHcloud stellt Ihnen Dienstleistungen zur Verfügung, für deren Konfiguration und Verwaltung Sie die alleinige Verantwortung tragen. Es liegt somit bei Ihnen, sicherzustellen, dass diese ordnungsgemäß funktionieren. Diese Anleitung soll Sie bei allgemeinen Aufgaben bestmöglich unterstützen. Dennoch empfehlen wir Ihnen, falls Sie Hilfe brauchen, einen [spezialisierten Dienstleister](https://partner.ovhcloud.com/de/directory/) zu kontaktieren und/oder Ihre Fragen in der OVHcloud Community zu stellen. Leider können wir Ihnen für administrative Aufgaben keine weitergehende technische Unterstützung anbieten. Weitere Informationen finden Sie am [Ende dieser Anleitung](#gofurther). ::: ### Grundlegende Funktionen #### Verbindung mit der OVHcloud API Klicken Sie auf der [OVHcloud API Seite](https://eu.api.ovh.com/) auf `Explore the OVH API `, um die Liste der API-Funktionen anzuzeigen. Um die API für Ihre Dienste zu verwenden, loggen Sie sich mit Ihren OVHcloud Zugangsdaten ein: - Klicken Sie oben rechts auf Authentication. - Klicken Sie anschließend auf Login with OVHcloud SSO. - Geben Sie Ihre OVHcloud Kunden-Zugangsdaten ein. - Klicken Sie auf den Button Authorize, um API-Aufrufe von dieser Seite aus zuzulassen. ![API](/images/manage-and-operate/api/first-steps/login.png) :::info Wenn Ihr OVHcloud Account durch [Zwei-Faktor-Authentifizierung](/de/guides/account-and-service-management/account-information/secure-ovhcloud-account-with-2fa.md) geschützt ist, müssen Sie auch den per SMS, OTP-Anwendung oder U2F-Schlüssel generierten Code eingeben. ::: #### Die mit API verfügbaren Dienste analysieren Alle OVHcloud Dienste, die über API-Zugang verwaltet werden können werden in der Liste links angezeigt. ![API](/images/manage-and-operate/api/first-steps/api-list.png) Um zum Beispiel die zu Domainnamen gehörenden API-Aufrufe anzuzeigen, klicken Sie auf **/domain** in der Liste. Nachdem Sie auf die Dienstbezeichnung geklickt haben, wird die Liste der verfügbaren API-Funktionen angezeigt. ![API](/images/manage-and-operate/api/first-steps/api-displayed.png) Sie haben auch einen Selektor auf der linken Seite der Produktliste, mit dem Sie zwischen den API-Zweigen **/v1** und **/v2** wählen können. Wenn Sie mit dem Prinzip der API-Verzweigung nicht vertraut sind, lesen Sie [unsere Dokumentation zur API v2](/de/guides/manage-and-operate/api/apiv2.md). #### API-Aufrufe ausführen Es sind 4 HTTP-Methoden für die API verfügbar: **GET** Die GET-Methode dient dem Abruf von Daten aus einer Ressource. Um zum Beispiel die Liste Ihrer Domainnamen abzurufen, verwenden Sie folgenden Aufruf: 🇪🇺EU▾ [GET/domain](https://eu.api.ovh.com/console/?section=/domain&branch=v1#get-/domain) **POST** Die POST-Methode wird verwendet, um zusätzliche Daten an die Ressource zu senden. Um zum Beispiel einen Eintrag zu Ihrer DNS Zone hinzuzufügen, verwenden Sie folgenden Aufruf: 🇪🇺EU▾ [POST/domain/zone/{zoneName}/record](https://eu.api.ovh.com/console/?section=/domain&branch=v1#post-/domain/zone/-zoneName-/record) **PUT** Die PUT-Methode dient dazu, die aktuellen Ressourcen-Daten durch die Daten der Abfrage zu ersetzen. Um beispielsweise einen Eintrag in Ihrer DNS Zone zu korrigieren, verwenden Sie folgenden Aufruf: 🇪🇺EU▾ [PUT/domain/zone/{zoneName}/record/{id}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#put-/domain/zone/-zoneName-/record/-id-) **DELETE** Die DELETE-Methode wird verwendet, um die Ressource zu löschen. Um beispielsweise einen Eintrag in Ihrer DNS Zone zu löschen, verwenden Sie folgenden Aufruf: 🇪🇺EU▾ [DELETE/domain/zone/{zoneName}/record/{id}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#delete-/domain/zone/-zoneName-/record/-id-) ##### Parameter der API Nachdem Sie auf den Endpunkt Ihrer Wahl geklickt haben, können Sie im Bereich **Request** Ausführungsvariablen eingeben. Um zum Beispiel einen TXT Eintrag in Ihrer DNS Zone hinzuzufügen, editieren Sie die folgenden Einstellungen: ![API](/images/manage-and-operate/api/first-steps/parameters.png) Wenn Sie die Parameter festgelegt haben, können Sie die Ausführung des Aufrufs starten, indem Sie auf `EXECUTE ` klicken. Der Tab `Response` zeigt den Bericht zur Durchführung des API-Aufrufs. ![API](/images/manage-and-operate/api/first-steps/result.png) Die Tabs `PHP` und `Python` enthalten die Elemente, die entsprechend der Anwendungssprache in Ihrem Skript hinzugefügt werden müssen. ### Fortgeschrittene Nutzung: OVHcloud API mit einer Anwendung verbinden #### Schlüssel für Ihre Anwendung erstellen Jede Anwendung, die mit der OVHcloud API kommunizieren möchte, muss zuerst freigegeben werden. Klicken Sie hierzu auf folgenden Link: [https://eu.api.ovh.com/createToken/](https://eu.api.ovh.com/createToken/). Geben Sie Ihre Kundenkennung, Ihr Passwort und den Namen Ihrer Anwendung ein. Der Name kann nützlich sein, um anderen Personen Zugriff zu gewähren. Sie können auch eine Beschreibung der Anwendung und eine Zeitangabe hinzufügen. Der Eintrag `Rights` erlaubt es, die Verwendung der Anwendung auf bestimmte Funktionen zu beschränken. Um eine HTTP-Methode für alle Endpunkte zu erlauben, geben Sie im Feld einen Stern (`*` ) ein. Im folgenden Beispiel werden alle GET-Abfragen erlaubt: ![API keys](/images/manage-and-operate/api/first-steps/api-keys.png) Wenn Sie auf `Create Keys ` klicken, erhalten Sie drei Schlüssel: - Den Anwendungsschlüssel **AK**. Zum Beispiel: ```console 7kbG7Bk7S9Nt7ZSV ``` - Den geheimen, nicht zur Veröffentlichung bestimmten Anwendungsschlüssel **AS**. Zum Beispiel: ```console EXEgWIz07P0HYwtQDs7cNIqCiQaWSuHF ``` - Den geheimen, nicht zur Veröffentlichung bestimmten "**Consumer Key**" oder **CK**. Zum Beispiel: ```console MtSwSrPpNjqfVSmJhLbPyr2i45lSwPU1 ``` In diesem Fall ist der Schlüssel vom Typ **CK** an Ihren Account gebunden. Der **CK**-Token kann für die Übertragung von Rechten verwendet werden. Weitere Informationen finden Sie in dieser Anleitung: [How to manage a customer’s account via OVHcloud API](/de/guides/manage-and-operate/api/first-steps.md) (EN). #### Erste Verwendung der API Sobald Ihre drei Schlüssel (**AK**, **AS**, **CK**) verfügbar sind, können Sie die API Anfragen signieren. Die Signatur wird wie folgt berechnet: ```console "$1$" + SHA1_HEX(AS+"+"+CK+"+"+METHOD+"+"+QUERY+"+"+BODY+"+"+TSTAMP) ``` Um die Entwicklung Ihrer Anwendungen zu vereinfachen, stellt OVHcloud API-Wrapper in mehreren Sprachen bereit. Wenn Sie diese verwenden, müssen Sie sich nicht um die Berechnung der Signatur kümmern und können sich auf die Programmierung Ihrer Anwendung konzentrieren. - _Go_ : [https://github.com/ovh/go-ovh](https://github.com/ovh/go-ovh) - _Perl_: [https://github.com/ovh/perl-ovh](https://github.com/ovh/perl-ovh) - _Python_: [https://github.com/ovh/python-ovh](https://github.com/ovh/python-ovh) - _PHP_: [https://github.com/ovh/php-ovh](https://github.com/ovh/php-ovh) - _Node.js_: [https://github.com/ovh/node-ovh](https://github.com/ovh/node-ovh) - _C#_: [https://github.com/ovh/csharp-ovh](https://github.com/ovh/csharp-ovh) Hier ein Beispiel für die Nutzung der Rubrik `/me` zur Verwaltung Ihres OVHcloud Kunden-Accounts: ```python import ovh # Instantiate. Visit https://api.ovh.com/createToken/?GET=/me # to get your credentials client = ovh.Client( endpoint='ovh-eu', application_key='', application_secret='', consumer_key='', ) # Print nice welcome message print("Welcome", client.get('/me')['firstname']) ``` #### Schlüssel auflisten und widerrufen Um Schlüssel aufzulisten und zu widerrufen, können Sie die [API-Konsole](https://eu.api.ovh.com/) oder das OVHcloud Kundencenter verwenden: **API-Konsole** - Auflisten der Schlüssel-IDs mit dem folgenden Aufruf: - Mit dem folgenden Aufruf erhalten Sie wichtige Informationen: - Schlüssel sperren mit dem folgenden Aufruf: 🇪🇺EU▾ [DELETE/me/api/application/{applicationId}](https://eu.api.ovh.com/console/?section=/me&branch=v1#delete-/me/api/application/-applicationId-) **OVHcloud Kundencenter** Gehen Sie zur Seite API-Schlüssel. ![API keys manager](/images/manage-and-operate/api/first-steps/api-keys-manager.png) ## Weiterführende Informationen [](#) [Domainnamen über die API verwalten](/de/guides/web-cloud/domains/api-domain-intro.md) (EN) [OVHcloud Kunden-Account über die API verwalten](/de/guides/manage-and-operate/api/first-steps.md) (EN) Treten Sie unserer [User Community](https://community.ovhcloud.com/) bei.