---
title: "API-basierte Übersetzung"
slug: "api-based-translation"
updated: 2026-05-07T00:40:52Z
published: 2026-05-29T04:29:47Z
canonical: "support.whatfix.com/api-based-translation"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.whatfix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API-basierte Übersetzung

Die API-basierte Übersetzung ist eine asynchrone Methode, bei der API-Anfragen um übersetzte Inhalte zu senden und zu empfangen.

Diese Methode sendet Textstrings oder JSON-Dateien an den Übersetzungsdienst des Drittanbieters und erhält den übersetzten Inhalt in derselben API-Antwort. Dies ist besonders vorteilhaft für kleinere Übersetzungsaufgaben oder wenn eine Bearbeitung in Echtzeit erforderlich ist.

Erweitern Sie die folgenden Akkordeons, um ein benutzerdefiniertes Übersetzungstool erfolgreich zu integrieren:

> [!WARNING]
> Note:
> 
> Bei der Einrichtung der Integration in den folgenden Schritten wird **Microsoft Azure** als Beispiel verwendet. Basierend auf Ihren Anforderungen und dem von Ihnen gewählten Tool richten Sie die Integration entsprechend ein.

****Schritt 1: Eines angepassten Tools für die API-basierte Übersetzung hinzufügen****

Whatfix ermöglicht es Ihnen, ein benutzerdefiniertes Übersetzungstool hinzuzufügen, das auf Ihren Anforderungen und internen Prozessen basiert.

Gehen Sie wie folgt vor, um ein Übersetzungstool basierend auf einer API-Anforderung hinzuzufügen:

1. Auf dem Whatfix Guidance Dashboard, klicken Sie **Einstellungen**.  

![ia_settings_without_auto_testing](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ia_settings_without_auto_testing.png?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

1. Klicken Sie **Übersetzungstools**.

![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_click_settings_translation_tools(3).jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)
2. Klicken Sie auf der Seite **Übersetzungstools** auf das Symbol **Hinzufügen**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_translation_tools_add_icon.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)
3. Geben Sie im Dialogfeld **Integration mit benutzerdefiniertem Tool** den Namen des Tools ein, und wählen Sie dann **API** als Übersetzungsmethode. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/translation_tools_name_api_based.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)
4. Klicken Sie **Weiter**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/translation_tools_continue.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

****Schritt 2: Zuordnung von Sprachen für die API-basierte Übersetzung****

Übersetzungstools verwenden Codes, um Sprachen zu unterscheiden und Inhalte zu übersetzen. Im **Map Languages** -Bereich konfigurieren Sie Sprachcodes, um die Ausgangs- und Zielsprache festzulegen. Sie müssen den in dem Übersetzungstool verwendeten Sprachcode mit der von Whatfix unterstützten Sprache abgleichen. Zum Beispiel Fr: fr (Französisch) und De: de (Deutsch).

> [!WARNING]
> Note:
> 
> - Sie müssen auch die **Primäre Sprache** zuordnen, die zur Erstellung von Whatfix-Inhalten verwendet wird. Andernfalls kann Whatfix den Inhalt nicht erkennen und für die Übersetzung senden.
> - Sobald Sie das Tool integriert haben, fügen Sie Sprachen direkt von der Seite **Übersetzungen** in der **Konfigurationen** Sektion hinzu: ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Dokumentation/translation_configurations_map _languages.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

Nachdem Sie ein Übersetzungstool hinzugefügt haben, verwenden Sie die folgenden Schritte, um Sprachen hinzuzufügen und diese zwischen Whatfix und dem benutzerdefinierten Übersetzungstool abzugleichen:

1. Im Abschnitt **Map Sprachen** wählen Sie die Dropdown-Liste aus und wählen Sie die Eingabesprache. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_map_languages_input_lang.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)
2. Geben Sie den Sprachcode ein, der vom Übersetzungstool erkannt wird. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_map_languages_input_lang_code.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)
3. Um weitere Sprachcodes zuzuordnen, klicken Sie **+ Sprachcode hinzufügen**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_map_languages_input_add_lang_code.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)
4. Wählen Sie die Eingabesprache aus und fügen Sie den Sprachcode hinzu. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_map_languages_add_lang_code.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

****Schritt 3: Whatfix-Daten in ein Format konvertieren, das vom benutzerdefinierten Tool akzeptiert wird****

Whatfix-Inhalt muss in ein Format umgewandelt werden, damit das Übersetzungswerkzeug die Daten empfangen und interpretieren kann. Dies umfasst die von und zur Sprache, Übersetzungsattribute und andere Details, um den Inhalt und die Felder im Inhalt, die eine Übersetzung erfordern, eindeutig zu identifizieren.

Was die folgenden Schritte angeht, um Whatfix-Daten in ein von dem Custom Tool akzeptiertes Format zu konvertieren:

> [!WARNING]
> Note:
> 
> Verweisen Sie auf [Richtlinien für das Übersetzungstool](/studio/docs/de/translation-tool-guidelines), um mehr über Javascript und Anforderungsparameter beim Konfigurieren der Schritte für das Anpassen des Übersetzungstools zu erfahren.

1. Geben Sie im Abschnitt **Whatfix-Daten in das von benutzerdefinierten Tool akzeptierte Format konvertieren** eine **Beschreibung** (Optional) ein. Standardmäßig ist der **Konfigurationstyp** auf **Javascript** eingestellt. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_translation_tools_2_desc_config.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)
2. Geben Sie im **Skript**-Feld den Javascript-Code ein, um Whatfix-Daten in ein Format zu konvertieren, das vom Benutzerdefinierten Übersetzungs Tool akzeptiert wird. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_translation_tools_2_script.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

Hier ist ein Beispiel für Javascript-Code für Microsoft Azure:

```javascript
funktion konvertiereZuMicrosoftÜbersetzungsEingabe(original_data) {
    var eingabeFürMs = [];
    für (var i = 0; i < original_data.length; i++) {
        var element = original_data[i];
        eingabeFürMs.push({
            "Text": element.value
        });
    }
    return eingabeFürMs;
}

var microsoftÜbersetzungsEingabe = konvertiereZuMicrosoftÜbersetzungsEingabe(attributes.translationStrings);
// Hier sehen wir, dass die zu übersetzenden Strings durch attributes.translationStrings zugegriffen werden können
output.data = microsoftÜbersetzungsEingabe;
```

> [!WARNING]
> Note:
> 
> Der JS-Skripteditor unterstützt nur Versionen vor ES6. Für weitere Informationen zur Spezifizierung von Variablen und Parametern sehen Sie [Richtlinien für Übersetzungswerkzeuge](/studio/docs/de/translation-tool-guidelines).

Der vorangehende Javascript-Code liest die translationStrings von Whatfix, formatiert sie in eine Struktur, die Microsoft akzeptiert, und speichert das Ergebnis in einer Variablen namens `output.data` für den nächsten Schritt.

****Schritt 4: API-Anfrage konfigurieren****

Dieser Schritt ermöglicht es Ihnen, übersetzten Inhalt über einen API-Anforderungsantrag vom benutzerdefinierten Übersetzungswerkzeug anzufordern.

Gehen Sie wie folgt vor, um die API-Anfrage zu konfigurieren:

1. Geben Sie im Abschnitt **Benutzerdefiniertes Tool konfigurieren** eine **Beschreibung** ein (optional) und wählen Sie den **Konfigurationstyp** aus Wählen Sie entweder den Typ **Javascript** oder **Anfrage**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_translation_tools_3_desc_config_type.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

> [!WARNING]
> Note:
> 
> Verweisen Sie auf [Richtlinien für das Übersetzungstool](/studio/docs/de/translation-tool-guidelines), um mehr über Javascript und Anforderungsparameter beim Konfigurieren der Schritte für das Anpassungstool zur Übersetzung zu erfahren.

Basierend auf der **Konfiguration** führen Sie die Schritte im folgenden Akkordeon aus:

****Anfrage****

A. Wählen Sie im **Methoden**-Dropdown **POST.**

![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_translation_tools_3_req_method.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

B. Geben Sie die **URL** ein.

![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_translation_tools_3_req_url.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D) Beispiel-URL:

```plaintext
https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&to=${attributes.targetLocale}&from=${attributes.sourceLocale}&textType=html
// Hier können wir sehen, dass wir für den Zugriff auf Quell und Zielgebietsschema attributes.sourceLocale und attributes.targetLocale verwenden
```

C. Geben Sie die Parameterdetails im **Headers**-Feld an. Aus Sicherheitsgründen klicken Sie auf das **Unhide**-Symbol und fügen Sie dann die Header hinzu.

![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_translation_tools_3_req_headers.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

Hier ist ein Beispielcode für **Header**:

```javascript
{
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY",
    "Ocp-Apim-Subscription-Region": "Global"
}
```

**Note**: Sie müssen den **Subscription Key** für das Anpassungstool angeben.

****Javascript****

Geben Sie im **Script**-Feld den Javascript-Code ein, um über das Anpassungsübersetzungs-Tool angeforderte Inhalte zu erhalten. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_translation_tools_2_script.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

#### Zusätzliche Konfigurationen

In bestimmten Szenarien, basierend auf dem anpassbaren Werkzeug, könnten zusätzliche Konfigurationsschritte erforderlich sein, um Inhalt zu erhalten. Verwenden Sie das **+ Konfiguration hinzufügen** -Symbol, um zusätzliche Schritte für die API-Anforderung bereitzustellen.![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/translation_tools_3_add_configuration.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

Ähnlich den oben hervorgehobenen Schritten, geben Sie die Einzelheiten im **Konfiguration 2** Abschnitt ein: ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/translation_tools_3_add_configuration_2.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

****Schritt 5: Das Format von benutzerdefiniertem Werkzeug in Whatfix Daten konvertieren****

Der von dem Übersetzungstool erhaltene Inhalt muss umstrukturiert werden, um mit dem Datenformat von Whatfix übereinzustimmen.

Verwenden Sie die folgenden Schritte, um das Format vom Benutzerdefinierten Übersetzungstool in das Whatfix Datenformat zu konvertieren:

1. Geben Sie im Abschnitt **Format von benutzerdefiniertem Tool in Whatfix Daten** eine **Beschreibung** (Optional) ein. Standardmäßig ist der **Konfigurationstyp** auf **Javascript** eingestellt. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_translation_tools_4_desc_type.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)
2. Geben Sie in das Feld **Skript** den Javascript-Code ein, um das Format des angepassten Tools in das von Whatfix akzeptierte Format zu konvertieren. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_translation_tools_2_script.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D) Hier ist ein Beispiel für Javascript-Code:

```javascript
function mergeTranslatedValues(original_data, translated_data) {
    var result = [];
    for (var i = 0; i < original_data.length; i++) {
        var originalItem = original_data[i];
        var translatedItem = translated_data[i];
        result.push({
            key: originalItem.key,
            value: translatedItem.translations[0].text
        });
    }
    return result;
}

var mergedData = mergeTranslatedValues(attributes.translationStrings, input);
// Output der vorherigen Schritte kann durch die Verwendung des Eingabeschlüsselworts zugegriffen werden
output.data = mergedData;
```

Der vorangegangene Javascript-Code kombiniert den übersetzten Text von Microsoft Azure mit den Originalschlüsseln von Whatfix und kann den übersetzten Text korrekt anzeigen.
3. Klicken Sie **Speichern** . ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/db_translation_tools_save.jpg?sv=2026-02-06&spr=https&st=2026-10-29T07%3A44%3A47Z&se=2026-10-29T08%3A44%3A47Z&sr=c&sp=r&sig=%2BovEPtJ7vQ%2FwA3nEzQVCh8id6OhC8cCkHPpPwbQMSBc%3D)

Um den Integrationsprozess abzuschließen, [aktivieren Sie das Tool für die angepasste Integration](/studio/docs/de/manage-the-custom-translation-tool) auf der Seite **Übersetzungstools**.

Ein API-Aufruf oder eine API-Anforderung ist eine Nachricht, die an einen Server gesendet wird, um Daten oder einen Dienst von einer Anwendungsprogrammierschnittstelle (API) anzufordern. APIs sind eine Reihe von Regeln und Protokollen, die es Softwareprogrammen ermöglichen, miteinander zu kommunizieren.