COYO API: Übersetzungen importieren (bis v26) – COYO Campus

Falls ihr mehrere Übersetzungen auf einmal einstellen möchtet, bietet es sich an, dies mit unserer REST API Schnittstelle durchzuführen.

Schritt 1: Finde heraus, welche Sprachen aktiviert sind

Führt diesen GET Befehl aus, um herauszufinden, welche Sprachen aktiviert sind und von dir übersetzt werden können:

GET /api/languages

So sieht euer Ergebnis aus, wenn ihr Deutsch und Englisch aktiviert habt:

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

Optionaler Schritt: Zusätzliche Sprache aktivieren

Falls ihr eine zusätzliche Sprache übersetzen wollt, könnt ihr das mit diesem PUT Befehl und body-Inhalt durchführen:

PUT /api/languages/<language>

Content-Type: application/json
{
  "active":true
}

Benutzt bei <language> das entsprechende Kürzel für die gewünschte Sprache.

Schritt 2: Eigene Übersetzung einfügen (wenn es noch keine Übersetzung gibt)

Führt diesen POST Befehl samt body aus, um eine neue Übersetzung zu importieren:

POST /api/languages/<language>/translations/<languagekey>

Content-Type: application/json
{
  "value":"<translation>"
}

Beachtet, dass ihr die Platzhalter entsprechend befüllen müsst:

bei <language> das entsprechende Kürzel für die gewünschte Sprache (EN, DE, ES,...)
bei <languagekey> den Key, welchen du anpassen willst und
bei <translation> die neue Übersetzung

Schritt 3: Eigene Übersetzung einfügen (wenn es schon eine Übersetzung gibt)

Führt diesen PUT Befehl samt body aus, um eine bereits bestehende Übersetzung anzupassen:

PUT /api/languages/<language>/translations/<languagekey>

Content-Type: application/json
{
  "value":"<translation>"
}

Beachtet, dass ihr die Platzhalter entsprechend befüllen müsst:

bei <language> das entsprechende Kürzel für die gewünschte Sprache (EN, DE, ES,...)
bei <languagekey> den Key, welchen du anpassen willst und
bei <translation> die neue Übersetzung

Schritt 4: Eigene Übersetzung löschen

Führt diesen DELETE Befehl aus, um eine bereits bestehende Übersetzung zu löschen:

DELETE /api/languages/<language>/translations/<languagekey>

Auch hier gilt: Die Platzhalter <language> und <languagekey> mit dem zu befüllen, welche ihr löschen wollt.

Schritt 5: Eigene Übersetzung anzeigen

Führt diesen GET Befehl aus, um bereits bestehende Übersetzungen zu sehen:

GET /api/languages/public/<language>/translations

Benutzt bei <language> das entsprechende Kürzel für deine gewünschte Sprache.

Hinweis:
Dieser Befehl gibt euch nur ausgefüllte Übersetzungen aus.