Du kannst die API von Haiilo verwenden, um einem Benutzer eine bestimmte Sprache zuzuweisen. Standardmäßig wird die Plattform für alle Benutzer in einer Standard Sprache angezeigt, bis sie ihre bevorzugte Sprache in ihren Account Einstellungen auswählen. Wenn du jedoch im Moderator-Modus arbeitest, kannst du die Sprache eines Benutzers über die API festlegen. Diese Funktion kann besonders nützlich sein, wenn du möchtest, dass Benutzer die Plattform in einer anderen Sprache als der Standardansicht, beim ersten Anmelden, sehen.

Du musst dich zuerst authentifizieren, um Anfragen an die Haiilo API zu stellen. Zusätzlich musst du im Moderator-Modus sein, um die Sprache eines Benutzers über den API-Aufruf zu ändern. Detaillierte Informationen zur Authentifizierung und Verwendung der API findest du in unserer API-Dokumentation.

Liste aller aktivierten Sprachen

Erhalte zunächst eine Liste deiner aktivierten Sprachen und ihrer Sprachkennungen mithilfe des folgenden API-Aufrufs.

1. Führe eine GET-Anfrage an den Endpunkt /api/languages durch.

Die Antwort sollte wie folgt aussehen, wenn du Englisch, Deutsch und Französisch aktiviert hast:

[
    {
        "language": "DE",
        "active": true,
        "defaultLanguage": false
    },
    {
        "language": "EN",
        "active": true,
        "defaultLanguage": true
    },
    {
        "language": "FR",
        "active": true,
        "defaultLanguage": false
    }
]

Setze die Sprache eines Benutzers

Weise dann einem Benutzer mithilfe des untenstehenden API-Aufrufs eine Sprache zu.

1. Starte eine neue Anfrage.
2. Kopiere eine Sprachkennung aus der Antwort für aktivierten Sprachen. Du kannst nur eine Sprache festlegen, die bereits auf der Plattform aktiviert wurde.
3. Gib das Folgende im Anfrage-Body ein:

   {
     "language" : "<Sprachkennung>" /* z.B. DE für Deutsch */
   }

4. Führe eine PUT-Anfrage an den Endpunkt /api/users/<user_id>/language durch, wobei <user_id> die ID des Benutzers ist, den du aktualisierst.

Nach einer erfolgreichen Antwort wird die Sprache des Benutzers geändert. Um die Sprache für mehrere Benutzer gleichzeitig über die API zu aktualisieren, kannst du ein Skript entwickeln.